Початок роботи

Довідка API BulkSMSAPI

BulkSMSAPI, це API для розробників для масової розсилки SMS: надсилайте один текст або пакет до 10 000 номерів за один запит до 227 країн через REST, відстежуйте кожне повідомлення за допомогою підписаних вебхуків і оплачуйте кожне повідомлення з попередньо оплаченого балансу. Ця довідка охоплює кожен ендпоінт, поле, подію та помилку, які має API. Кожна сторінка також доступна у форматі Markdown: додайте .md до її адреси.

Базова URL-адреса та формат

Усі запити надсилаються на https://bulksmsapi.cc/v1 через HTTPS. Тіла запитів, це JSON (Content-Type: application/json, UTF-8), і кожна відповідь, це JSON, включаючи помилки. Час вказується у форматі ISO 8601 в UTC. Гроші, це рядок у доларах США з п’ятьма знаками після коми ("0.00507"), тому ціни менші за цент є точними.

Ендпоінти

Метод та шляхЩо робитьKey
POST /v1/messagesНадіслати один текст на один номерYes
POST /v1/batchesНадіслати до 10 000 номерів, один текст або окремий текст для кожного номераYes
GET /v1/messages/{id}Одне повідомлення зі статусом та ціноюYes
GET /v1/messagesПовідомлення, спочатку новіші, фільтр за пакетом або статусомYes
GET /v1/batches/{id}Один пакет із кількістю за статусамиYes
GET /v1/batchesПакети, спочатку новішіYes
POST /v1/batches/{id}/cancelСкасувати запланований пакет, повне повернення коштівYes
POST /v1/estimatesОцінити запит без відправкиYes
GET /v1/balanceБаланс у USDYes
GET /v1/pricingЦіна за сегмент для кожної країниNo
GET /v1/pricing/{country}Ціна для однієї країни (ISO код)No

Перший запит

Створіть API ключ у консолі, експортуйте його та відправте повідомлення. Відповідь, 202 із об’єктом повідомлення: вартість знімається з балансу, а повідомлення стає в чергу.

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'
202 AcceptedJSON
{
  "id": "msg_8F3K2Q9TZ1MX",
  "object": "message",
  "batch_id": "bat_4M7Q1X0PK2RS",
  "to": "+14155550123",
  "country": "US",
  "text": "Your Northwind code is 482913. It expires in 10 minutes.",
  "segments": 1,
  "price": "0.00507",
  "currency": "USD",
  "status": "queued",
  "error": null,
  "reference": "login-7781",
  "created_at": "2026-11-07T09:30:12.418Z",
  "sent_at": null,
  "done_at": null
}

Як рухається повідомлення

Прийняті повідомлення мають статус queued (або scheduled, якщо в запиті є send_at). Черга передає їх у мережу кожні дві секунди, до 1,200 на хвилину для одного акаунта, і вони стають sent. Фінальний статус: delivered або failed; невдале повідомлення одразу повертається на баланс. Кожен фінальний статус викликає ваш вебхук із підписаною подією.

Ліміти в огляді

ЛімітЗначення
Одержувачі на один API запит10,000
Одержувачі на одну кампанію в консолі50,000
Запитів на хвилину на один ключ600
Повідомлень, переданих до мережі на хвилину для одного акаунта1,200
Найдовший текст10 сегментів (1,530 GSM-7 або 670 UCS-2 символів)
Вікно плануванняВід 2 хвилин до 45 днів вперед
Спроби вебхука на одну подію10
Пам’ять Idempotency-Key24 години
API ключів на один акаунт10

Машиночитані файли

  • OpenAPI 3.1 spec для генераторів коду та API клієнтів.
  • llms-full.txt: весь цей довідник у вигляді одного текстового файлу.
  • Кожна сторінка документації у форматі Markdown, наприклад /en/docs/webhooks.md.
Довідка API BulkSMSAPI | BulkSMSAPI Docs