- 1xx: Informational — передає інформацію на рівні протоколу передачі.
- 2xx: Success — запит було успішно виконано.
- 3xx: Redirection — клієнт має виконати додаткову дію, щоб завершити запит.
- 4xx: Client Error — запит не виконано через помилку клієнта.
- 5xx: Server Error — запит не виконано через помилку сервера.
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 призупинено.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 через заголовки відповіді:x-ratelimit-max: Показує максимально дозволену кількість запитів за 5-хвилинний періодx-ratelimit-count: Показує, скільки запитів ви зробили за поточний 5-хвилинний період
Ми рекомендуємо перевіряти відповіді з кодом помилки 429. Якщо ви бачите помилку 429, ви досягли свого
rate limit. Повторні спроби перевищити rate limit можуть призвести до призупинення User Profile.Дізнайтеся більше про обробку rate limits для кількох user profiles.
Rate Limits аналітики платформ
HTTP429 також може повертатися, коли соціальна мережа обмежує виклики аналітики для конкретного облікового запису — незалежно від ваших лімітів Ayrshare User Profile. У цьому випадку відповідь містить специфічний для платформи код помилки Ayrshare (наприклад, code: 444 для обмежень аналітики на 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 зазнав внутрішньої помилки або обробка не вдалася.