> ## Documentation Index
> Fetch the complete documentation index at: https://ayrshare.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP Status Codes

> Коди HTTP, які повертаються з відповіддю.

Помилки повертатимуться зі [стандартними HTTP status codes](https://tools.ietf.org/html/rfc2616#section-10).

Коди статусу такі:

<ul class="custom-bullets">
  <li>1xx: Informational — передає інформацію на рівні протоколу передачі.</li>
  <li>2xx: Success — запит було успішно виконано.</li>
  <li>3xx: Redirection — клієнт має виконати додаткову дію, щоб завершити запит.</li>
  <li>4xx: Client Error — запит не виконано через помилку клієнта.</li>
  <li>5xx: Server Error — запит не виконано через помилку сервера.</li>
</ul>

### 200 Success

Запит було успішно виконано.

### 400 Bad Request

Помилка `400 Bad Request` означає, що сервер не зміг продовжити з обробкою запиту. Найпоширеніша причина помилки — неправильний синтаксис у URL-адресі запиту або тілі.

### 401 Unauthorized

Помилки `401 Unauthorized` зазвичай спричинені проблемою в заголовку запиту вашого API-виклику, тобто ви не використали дійсний API key для API-виклику.

### 403 Access Denied

Коли ваш застосунок виконує API-виклик з вашим API key і запит не дозволено.
403 також може повертатися, якщо [User Profile призупинено](/multiple-users/manage-user-profiles#reactivate-a-suspended-user-profile).

### 404 Resource Not Found

Ця помилка виникає, коли ваш застосунок намагається викликати API або отримати сутність, яка не існує.

### 405 Method Not Allowed

Ця помилка вказує, що методи HTTP-протоколу у вашому запиті не підтримуються. Перевірте документацію API, щоб побачити підтримувані методи.

### 429 Rate Limit

#### User Profile Rate Limits

Кожен User Profile має rate limit 300 API-запитів на 5-хвилинний інтервал. Ви можете моніторити використання свого rate limit через заголовки відповіді:

<ul class="custom-bullets">
  <li>`x-ratelimit-max`: Показує максимально дозволену кількість запитів за 5-хвилинний період</li>

  <li>
    `x-ratelimit-count`: Показує, скільки запитів ви зробили за поточний 5-хвилинний період
  </li>
</ul>

<Info>
  Ми рекомендуємо перевіряти відповіді з кодом помилки 429. Якщо ви бачите помилку 429, ви досягли свого
  rate limit. Повторні спроби перевищити rate limit можуть призвести до призупинення User Profile.

  Дізнайтеся більше про [обробку rate limits](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/) для кількох user profiles.
</Info>

#### Rate Limits аналітики платформ

HTTP `429` також може повертатися, коли соціальна мережа обмежує виклики аналітики для конкретного облікового запису — незалежно від ваших лімітів Ayrshare User Profile. У цьому випадку відповідь містить специфічний для платформи код помилки Ayrshare (наприклад, [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit) для обмежень аналітики на Facebook Page). Перевірте поле `code`, щоб відрізнити rate limit профілю від throttle на стороні платформи, і повторіть спробу з backoff, а не пропонуйте користувачеві повторно прив'язати обліковий запис.

#### Rate Limits для видалення User Profile

Ви можете видаляти 8 user profiles на секунду. Розподіліть API-виклики, якщо вам потрібно виконати bulk-видалення.

#### Захист від Rate Limit та політика призупинення

Для захисту цілісності нашої системи ми впроваджуємо автоматичне призупинення, якщо User Profile перевищує rate limits занадто часто.
Ось як це працює:

Коли ви робите API-запити, ви повинні уважно керувати 5-хвилинним вікном.
Наприклад, якщо ви робите 300 запитів за одну хвилину, вам доведеться чекати ще чотири хвилини, перш ніж робити додаткові запити.
Будь-які запити протягом цього періоду очікування спричинять відповідь з помилкою `429`.

Якщо User Profile накопичує 1 000 порушень rate limit (помилки 429) протягом 24-годинного періоду, профіль буде автоматично призупинено.
Після закінчення 5-хвилинного періоду очікування ви можете відновити запити до стандартного ліміту 300 за 5-хвилинне вікно.

### 500 Internal Server Error

`500 Internal Server Error` вказує, що Ayrshare зазнав внутрішньої помилки або обробка не вдалася.