Magsimula

Sanggunian ng Bulk SMS API

Ang BulkSMSAPI ay isang bulk SMS API para sa mga developer: magpadala ng isang teksto o batch ng hanggang 10,000 numero bawat request sa 227 bansa gamit ang REST, subaybayan ang bawat mensahe gamit ang signed webhooks, at magbayad bawat mensahe mula sa prepaid balance. Saklaw ng sangguniang ito ang bawat endpoint, field, event at error ng API. Available din ang bawat pahina bilang Markdown: idagdag ang .md sa address nito.

Base URL at format

Lahat ng request ay pupunta sa https://bulksmsapi.cc/v1 gamit ang HTTPS. Ang mga body ay JSON (Content-Type: application/json, UTF-8), at ang bawat sagot ay JSON, kasama ang mga error. Ang mga oras ay ISO 8601 sa UTC. Ang pera ay string sa US dollars na may limang decimal ("0.00507"), kaya eksakto ang mga presyong mas mababa sa isang sentimo.

Mga endpoint

Method at pathKung ano ang ginagawa nitoKey
POST /v1/messagesMagpadala ng isang teksto sa isang numeroYes
POST /v1/batchesMagpadala sa hanggang 10,000 numero, isang teksto o isa bawat numeroYes
GET /v1/messages/{id}Isang mensahe kasama ang status at presyo nitoYes
GET /v1/messagesMga mensahe, pinakabago muna, i-filter ayon sa batch o statusYes
GET /v1/batches/{id}Isang batch na may bilang bawat statusYes
GET /v1/batchesMga batch, pinakabago munaYes
POST /v1/batches/{id}/cancelKanselahin ang naka-schedule na batch, buong refundYes
POST /v1/estimatesPresyuhan ang request nang hindi ipapadalaYes
GET /v1/balanceBalance sa USDYes
GET /v1/pricingPresyo bawat segment para sa bawat bansaNo
GET /v1/pricing/{country}Presyo para sa isang bansa (ISO code)No

Unang request

Gumawa ng API key sa console, i-export ito, at magpadala ng mensahe. Ang sagot ay 202 kasama ang message object: ang gastos ay kukunin mula sa balance at ang mensahe ay ma-queue.

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
}

Paano gumagalaw ang mensahe

Ang tinanggap na mensahe ay queued (o scheduled kapag ang request ay may send_at). Ang queue ay ipapasa ito sa network tuwing dalawang segundo, hanggang 1,200 bawat minuto bawat account, at magiging sent. Ang huling status ay delivered o failed; ang failed na mensahe ay irerefund sa balance agad. Bawat huling status ay tatawag sa iyong webhook na may signed event.

Mga limitasyon sa isang sulyap

LimitHalaga
Mga tatanggap bawat API request10,000
Mga tatanggap bawat console campaign50,000
Mga request bawat minuto bawat key600
Mga mensaheng ipinasa sa network bawat minuto bawat account1,200
Pinakamahabang text10 segments (1,530 GSM-7 o 670 UCS-2 characters)
Window ng schedule2 minuto hanggang 45 araw nang maaga
Mga pagsubok sa webhook bawat event10
Memory ng Idempotency-Key24 oras
Mga API key bawat account10

Mga file na mababasa ng makina

Sanggunian ng Bulk SMS API | BulkSMSAPI Docs