Ошибки HTTP: 400, 401, 402, 403, 409, 429
Что означает HTTP-код ответа и в каких случаях стоит повторить запрос.
Справочник WAIX
| Код | Что проверить | Повторять автоматически? |
|---|---|---|
| 400 | JSON, UUID, обязательные поля, формат номера и параметры. | После исправления запроса. |
| 401 | Заголовок Bearer, действительность ключа, отзыв или выход из сессии. | После восстановления доступа. |
| 402 | Рабочую подписку или лимит номеров PHONE_CAPACITY_EXCEEDED. | После оплаты или изменения подключения. |
| 403 | Права ключа и роль сотрудника. | После выдачи нужного доступа. |
| 404 | ID, организация, существование объекта. | После уточнения идентификатора. |
| 409 | Конфликт Idempotency-Key, состояние подписки или ресурса. | После разбора конкретного конфликта. |
| 429 | Retry-After и скорость запросов. | С задержкой и тем же ключом операции. |
| 5xx | Состояние сервиса, сети и внешнего провайдера. | С увеличением паузы между попытками и прежним Idempotency-Key. Ограничьте число повторов. |
Лимиты
По умолчанию WAIX принимает до 120 запросов отправки в минуту с одного IP; настройка сервера может отличаться. У Meta действуют отдельные лимиты. При HTTP 429 учитывайте Retry-After, сократите число одновременных запросов и добавьте паузу со случайным отклонением, чтобы повторы не приходили одновременно.
Для поддержки
Сохраните путь и метод, HTTP-код, обезличенное тело ошибки, время с часовым поясом и ID запроса, если он есть в ответе. Код HTTP 400 и числовой код Meta внутри причины ошибки — разные значения.
Остался вопрос по этой инструкции?Написать в поддержку →