Reference
Ошибки API и коды ошибок
Ошибки используют HTTP-коды статусов и всегда имеют одно и то же JSON-тело. param указывает поле, если оно является причиной. Каждый ответ имеет заголовок X-Request-Id: укажите его в тикете поддержки.
{
"error": {
"code": "text_too_long",
"message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
"param": "text",
"doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
}
}Коды
| code | HTTP | Причина | Деньги |
|---|---|---|---|
| invalid_json | 400 | Тело запроса не является JSON-объектом или Content-Type не application/json. | Исправьте тело запроса. Ничего не было списано. |
| invalid_request | 400 | Отсутствует поле или указан неверный тип; параметр указывает на него. | Исправьте поле. Ничего не было списано. |
| invalid_number | 400 | Ни один номер в запросе не соответствует формату E.164 (+ и от 7 до 15 цифр). | Проверьте номера. Ничего не было списано. |
| unsupported_country | 400 / 404 | Нет данных о стоимости для страны номеров или GET /v1/pricing/{country} содержит неизвестный код. | Проверьте список стран. Ничего не было списано. |
| text_too_long | 400 | Текст требует более 10 сегментов. | Сократите текст. Ничего не было списано. |
| too_many_recipients | 400 | Более 10 000 получателей в одном запросе. | Разделите список. Ничего не было списано. |
| schedule_out_of_range | 400 | send_at не является допустимым временем (от 2 минут до 45 дней от текущего момента). | Выберите другое время. Ничего не было списано. |
| suppressed | 400 | Все номера в запросе находятся в вашем списке исключений (настройки в консоли). | Ничего не было отправлено или списано. |
| unauthorized | 401 | Отсутствует или некорректен заголовок Authorization, либо ключ был отозван. | Используйте действующий ключ. Ничего не было списано. |
| top_up_required | 402 | Баланс меньше стоимости запроса; в сообщении указаны обе суммы. | Пополните баланс и отправьте снова. Ничего не было списано. |
| not_found | 404 | Указанный id не существует в этом аккаунте или endpoint не существует. | Проверьте id и путь. |
| idempotency_conflict | 409 | Idempotency-Key использовался с другим телом запроса в последние 24 часа. | Используйте новый ключ для нового запроса. |
| not_cancelable | 409 | Отменить можно только запланированный пакет; этот уже начал или завершил отправку. | Ничего не изменилось. |
| rate_limited | 429 | Ключ выполнил более 600 запросов за последние 60 секунд. | Подождите указанное в Retry-After количество секунд. Ничего не было списано. |
| server_error | 500 | Произошла ошибка на нашей стороне. | Повторите с тем же Idempotency-Key. |
Повторная попытка
- Ошибки 4xx, кроме 429, требуют изменения запроса; повторная отправка того же запроса приведет к той же ошибке.
- При ошибке 429 подождите количество секунд, указанное в Retry-After.
- При ошибке 5xx или тайм-ауте сети повторите с тем же Idempotency-Key: если первый запрос был принят, вы получите его ответ вместо повторной отправки.