Ліміти API та повторні запити

Ліміти API та повторні запити визначаються контрактом між програмою та API. Клієнт повинен розрізняти успішну відповідь, неправильні вхідні дані, помилку автентифікації, перевищення ліміту та тимчасову помилку сервера. Формат JSON або XML не змінює значення HTTP-кодів.

Як обробити відповідь API

Перевіряйте HTTP-код, Content-Type і документовані поля відповіді. Для 429 враховуйте Retry-After, якщо сервер його повертає, і не повторюйте запити безкінечно. Перед автоматичним повтором операції переконайтеся, що він не створить дубльовану дію.

Важлива деталь

Після HTTP 429 перевірте Retry-After, якщо він є, замість фіксованої паузи навмання. Обмежуйте кількість повторів і використовуйте поступове збільшення затримки. Не повторюйте автоматично операцію, яка може створити дубльовану дію. Для реального запиту й актуального контракту API відкрийте API 2ip.