Довідка
Помилки 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 не існує в цьому акаунті, або ендпоінт не існує. | Перевірте 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: якщо перший запит був прийнятий, ви отримаєте його відповідь замість повторного надсилання.