การส่ง

ส่ง SMS ด้วย POST /v1/messages

POST/v1/messages

ส่งข้อความหนึ่งรายการไปยังหมายเลขเดียว ค่าบริการจะถูกหักจากยอดเงินเมื่อคำขอได้รับการยอมรับ

เนื้อหาคำขอ

  • tostringจำเป็น

    หมายเลขในรูปแบบสากล เช่น +14155550123 ช่องว่าง, ยัติภังค์, วงเล็บ และคำนำหน้า 00 จะถูกทำความสะอาด

  • textstringจำเป็น

    ข้อความ สูงสุด 10 segments; ดู Text and segments

  • referencestringไม่จำเป็น

    รหัสของคุณเอง สูงสุด 100 ตัวอักษร จะปรากฏในออบเจ็กต์ข้อความและทุก webhook

  • send_atstringไม่จำเป็น

    เวลาในการส่งในรูปแบบ ISO 8601 เร็วสุด 2 นาที ช้าสุด 45 วัน หากไม่ระบุ ข้อความจะเข้าคิวทันที

เพิ่มเฮดเดอร์ Idempotency-Key เพื่อให้การลองส่งซ้ำปลอดภัย: ดู Idempotency

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
}

ออบเจ็กต์ข้อความ

ฟิลด์

  • idstring

    รหัสข้อความ ขึ้นต้นด้วย msg_ ตามด้วยอักษร 12 ตัว

  • objectstring

    เป็น message เสมอ

  • batch_idstring

    batch ที่ข้อความนี้เป็นส่วนหนึ่ง (ข้อความเดียวก็จะได้รับ batch เช่นกัน)

  • tostring

    หมายเลขในรูปแบบ E.164 หลังทำความสะอาด

  • countrystring

    รหัส ISO 3166 ของประเทศที่กำหนดราคาหมายเลข

  • textstring

    ข้อความที่ส่งออก merge fields ถูกเติมแล้ว

  • segmentsinteger

    จำนวน segments ของ SMS ที่ข้อความใช้

  • pricestring

    ราคาข้อความนี้ใน USD ทศนิยม 5 ตำแหน่ง (ราคาต่อ segment คูณด้วยจำนวน segments)

  • currencystring

    เป็น USD เสมอ

  • statusstring

    scheduled, queued, sent, delivered, failed หรือ canceled

  • errorobject or null

    สำหรับข้อความที่ failed หรือ canceled: รหัสและข้อความ

  • referencestring or null

    รหัสอ้างอิงของคุณจากคำขอ

  • created_atstring

    เวลาที่คำขอได้รับการยอมรับ (ISO 8601, UTC)

  • sent_atstring or null

    เวลาที่ข้อความถูกส่งให้เครือข่าย

  • done_atstring or null

    เวลาที่ตั้งสถานะสุดท้าย (delivered, failed หรือ canceled)

ดึงข้อมูลข้อความ

GET/v1/messages/{id}

ข้อความหนึ่งรายการตามรหัส msg_ ข้อความของบัญชีอื่นจะตอบกลับด้วย 404

curl https://bulksmsapi.cc/v1/messages/msg_8F3K2Q9TZ1MX \
  -H "Authorization: Bearer $BULKSMSAPI_KEY"

แสดงรายการข้อความ

GET/v1/messages

ข้อความของบัญชี เรียงจากใหม่ที่สุด

พารามิเตอร์การค้นหา

  • batch_idstringไม่จำเป็น

    เฉพาะข้อความของแบทช์ bat_ นี้

  • statusstringไม่จำเป็น

    scheduled, queued, sent, delivered, failed หรือ canceled

  • limitintegerไม่จำเป็น

    1 ถึง 100 ค่าเริ่มต้น 20

  • starting_afterstringไม่จำเป็น

    msg_ id: หน้าเริ่มต้นหลังจากนี้ ใช้ id สุดท้ายของหน้าก่อนหน้า

curl "https://bulksmsapi.cc/v1/messages?status=failed&limit=50" \
  -H "Authorization: Bearer $BULKSMSAPI_KEY"
200 OKJSON
{
  "object": "list",
  "data": [ { "id": "msg_8F3K2Q9TZ1MX", "object": "message", "status": "failed", "...": "..." } ],
  "has_more": false
}
ส่ง SMS ด้วย POST /v1/messages | BulkSMSAPI Docs