Лимиты API и повторные запросы

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

Как обработать ответ API

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

Важная деталь

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