เริ่มต้นใช้งาน

เอกสารอ้างอิง Bulk SMS API

BulkSMSAPI คือ API SMS แบบกลุ่มสำหรับนักพัฒนา: ส่งข้อความหนึ่งฉบับหรือชุดสูงสุด 10,000 หมายเลขต่อคำขอไปยัง 227 ประเทศผ่าน REST, ติดตามทุกข้อความด้วย webhooks ที่ลงนาม, และจ่ายต่อข้อความจากยอดเงินเติมล่วงหน้า เอกสารอ้างอิงนี้ครอบคลุมทุก endpoint, ฟิลด์, เหตุการณ์และข้อผิดพลาดที่ API มี ทุกหน้ายังมีให้ในรูปแบบ Markdown: เพิ่ม .md ที่ท้ายที่อยู่

URL ฐานและรูปแบบ

คำขอทั้งหมดไปที่ https://bulksmsapi.cc/v1 ผ่าน HTTPS เนื้อหาเป็น JSON (Content-Type: application/json, UTF-8) และทุกคำตอบเป็น JSON รวมถึงข้อผิดพลาด เวลาเป็น ISO 8601 ใน UTC เงินเป็นสตริงในดอลลาร์สหรัฐที่มีทศนิยมห้าตำแหน่ง ("0.00507") ดังนั้นราคาต่ำกว่าเซ็นต์จึงแม่นยำ

Endpoints

เมธอดและเส้นทางสิ่งที่ทำKey
POST /v1/messagesส่งข้อความหนึ่งฉบับไปยังหมายเลขหนึ่งYes
POST /v1/batchesส่งไปยังสูงสุด 10,000 หมายเลข ข้อความหนึ่งฉบับหรือหนึ่งฉบับต่อหมายเลขYes
GET /v1/messages/{id}ข้อความหนึ่งฉบับพร้อมสถานะและราคาYes
GET /v1/messagesข้อความ, เรียงจากใหม่สุด, กรองตาม batch หรือสถานะYes
GET /v1/batches/{id}หนึ่ง batch พร้อมจำนวนตามสถานะYes
GET /v1/batchesBatches, เรียงจากใหม่สุดYes
POST /v1/batches/{id}/cancelยกเลิก batch ที่ถูกจัดตารางไว้, คืนเงินเต็มจำนวนYes
POST /v1/estimatesคำนวณราคาของคำขอโดยไม่ต้องส่งYes
GET /v1/balanceยอดเงินคงเหลือใน USDYes
GET /v1/pricingราคาต่อ segment สำหรับทุกประเทศNo
GET /v1/pricing/{country}ราคาสำหรับหนึ่งประเทศ (รหัส ISO)No

คำขอแรก

สร้าง API key ในคอนโซล, ส่งออก, และส่งข้อความ คำตอบคือ 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; ข้อความที่ล้มเหลวจะถูกคืนเงินเข้าบัญชีทันที สถานะสุดท้ายแต่ละครั้งจะเรียก webhook ของคุณด้วยอีเวนต์ที่ลงลายเซ็น

ขีดจำกัดโดยสังเขป

จำกัดค่า
ผู้รับต่อคำขอ API10,000
ผู้รับต่อแคมเปญในคอนโซล50,000
คำขอต่อนาทีต่อ key600
ข้อความที่ส่งไปยังเครือข่ายต่อนาทีต่อบัญชี1,200
ข้อความที่ยาวที่สุด10 segments (1,530 GSM-7 หรือ 670 UCS-2 ตัวอักษร)
ช่วงเวลาการกำหนดเวลาล่วงหน้า 2 นาทีถึง 45 วัน
ความพยายามเรียก webhook ต่ออีเวนต์10
ความจำของ Idempotency-Key24 ชั่วโมง
API keys ต่อบัญชี10

ไฟล์ที่เครื่องอ่านได้

  • OpenAPI 3.1 spec สำหรับเครื่องมือสร้างโค้ดและไคลเอนต์ API
  • llms-full.txt: คู่มือทั้งหมดนี้ในรูปแบบไฟล์ข้อความธรรมดา
  • ทุกหน้าคู่มือในรูปแบบ Markdown, เช่น /en/docs/webhooks.md
เอกสารอ้างอิง Bulk SMS API | BulkSMSAPI Docs