Bắt đầu

Tài liệu API Bulk SMS

BulkSMSAPI là API SMS hàng loạt cho nhà phát triển: gửi một tin nhắn hoặc một batch tới 10,000 số mỗi yêu cầu tới 227 quốc gia qua REST, theo dõi mọi tin nhắn bằng webhooks có chữ ký, và thanh toán theo tin từ số dư trả trước. Tài liệu này bao phủ mọi endpoint, trường, sự kiện và lỗi của API. Mỗi trang cũng có sẵn dạng Markdown: thêm .md vào địa chỉ.

URL cơ sở và định dạng

Mọi yêu cầu gửi tới https://bulksmsapi.cc/v1 qua HTTPS. Nội dung là JSON (Content-Type: application/json, UTF-8), và mọi phản hồi đều là JSON, bao gồm lỗi. Thời gian theo ISO 8601 UTC. Tiền tệ là chuỗi USD với năm số thập phân ("0.00507"), nên giá dưới 1 cent vẫn chính xác.

Các endpoint

Phương thức và đường dẫnChức năngKey
POST /v1/messagesGửi một tin tới một sốYes
POST /v1/batchesGửi tới 10,000 số, một tin chung hoặc riêng từng sốYes
GET /v1/messages/{id}Một tin nhắn với trạng thái và giáYes
GET /v1/messagesTin nhắn, mới nhất trước, lọc theo batch hoặc trạng tháiYes
GET /v1/batches/{id}Một batch với số lượng theo từng trạng tháiYes
GET /v1/batchesCác batch, mới nhất trướcYes
POST /v1/batches/{id}/cancelHủy batch đã lên lịch, hoàn tiền đầy đủYes
POST /v1/estimatesTính giá một yêu cầu mà không gửiYes
GET /v1/balanceSố dư bằng USDYes
GET /v1/pricingGiá mỗi segment cho mọi quốc giaNo
GET /v1/pricing/{country}Giá cho một quốc gia (mã ISO)No

Yêu cầu đầu tiên

Tạo API key trong console, xuất nó ra và gửi tin nhắn. Phản hồi sẽ là 202 với đối tượng tin nhắn: chi phí được trừ từ số dư và tin nhắn được đưa vào hàng đợi.

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
}

Hành trình tin nhắn

Tin nhắn được chấp nhận sẽ ở trạng thái queued (hoặc scheduled nếu yêu cầu có send_at). Hàng đợi chuyển chúng tới mạng mỗi 2 giây, tối đa 1,200 tin mỗi phút mỗi tài khoản, và chúng chuyển sang trạng thái sent. Trạng thái cuối cùng là delivered hoặc failed; tin nhắn thất bại sẽ được hoàn tiền ngay lập tức vào số dư. Mỗi trạng thái cuối sẽ gọi webhook của bạn với một sự kiện đã ký.

Tổng quan giới hạn

Giới hạnGiá trị
Người nhận mỗi yêu cầu API10,000
Người nhận mỗi chiến dịch console50,000
Yêu cầu mỗi phút mỗi key600
Tin nhắn chuyển tới mạng mỗi phút mỗi tài khoản1,200
Văn bản dài nhất10 segments (1,530 ký tự GSM-7 hoặc 670 ký tự UCS-2)
Khung thời gian lên lịchTừ 2 phút đến 45 ngày sau
Số lần thử webhook mỗi sự kiện10
Bộ nhớ Idempotency-Key24 giờ
API keys mỗi tài khoản10

Tệp máy đọc

Tài liệu API Bulk SMS | Tài liệu BulkSMSAPI