อ้างอิง

ข้อผิดพลาด API และรหัสข้อผิดพลาด

ข้อผิดพลาดใช้สถานะ HTTP และมี JSON body เดียวกันเสมอ param ระบุฟิลด์เมื่อฟิลด์หนึ่งเป็นสาเหตุ ทุกคำตอบมีหัวข้อ X-Request-Id: อ้างอิงในตั๋วสนับสนุน

400 Bad RequestJSON

{
  "error": {
    "code": "text_too_long",
    "message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
    "param": "text",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
  }
}

รหัส

code	HTTP	สาเหตุ	เงิน
invalid_json	400	เนื้อหาไม่ใช่ JSON object หรือ Content-Type ไม่ใช่ application/json	แก้ไขเนื้อหา ไม่มีการเรียกเก็บเงิน
invalid_request	400	ฟิลด์หายไปหรือมีประเภทไม่ถูกต้อง; พารามิเตอร์ระบุชื่อ	แก้ไขฟิลด์ ไม่มีการเรียกเก็บเงิน
invalid_number	400	ไม่มีหมายเลขในคำขอที่อ่านเป็นรูปแบบ E.164 ได้ (+ และตัวเลข 7-15 หลัก)	ตรวจสอบหมายเลข ไม่มีการเรียกเก็บเงิน
unsupported_country	400 / 404	ไม่มีประเทศที่กำหนดราคาตรงกับหมายเลข หรือ GET /v1/pricing/{country} มีรหัสที่ไม่รู้จัก	ตรวจสอบรายชื่อประเทศ ไม่มีการเรียกเก็บเงิน
text_too_long	400	ข้อความต้องใช้มากกว่า 10 segments	ย่อข้อความ ไม่มีการเรียกเก็บเงิน
too_many_recipients	400	มีผู้รับมากกว่า 10,000 รายการในหนึ่งคำขอ	แยกรายชื่อ ไม่มีการเรียกเก็บเงิน
schedule_out_of_range	400	send_at ไม่ใช่เวลาที่ถูกต้อง (ต้องอยู่ระหว่าง 2 นาทีถึง 45 วันจากนี้)	เลือกเวลาอื่น ไม่มีการเรียกเก็บเงิน
suppressed	400	ทุกหมายเลขในคำขออยู่ในรายชื่อไม่ส่ง (ตั้งค่าในคอนโซล)	ไม่มีการส่งหรือเรียกเก็บเงิน
unauthorized	401	ไม่มี Authorization header, รูปแบบไม่ถูกต้อง หรือยกเลิกคีย์แล้ว	ส่งคีย์ที่ใช้งานได้ ไม่มีการเรียกเก็บเงิน
top_up_required	402	ยอดเงินน้อยกว่าค่าใช้จ่ายของคำขอ ข้อความแสดงจำนวนทั้งสอง	เติมเงินและส่งอีกครั้ง ไม่มีการเรียกเก็บเงิน
not_found	404	ไม่มี id นี้ในบัญชี หรือไม่มี endpoint นี้	ตรวจสอบ id และ path
idempotency_conflict	409	ใช้ Idempotency-Key กับเนื้อหาคำขอที่ต่างกันใน 24 ชั่วโมงที่ผ่านมา	ใช้คีย์ใหม่สำหรับคำขอใหม่
not_cancelable	409	ยกเลิกได้เฉพาะ batch ที่จัดตารางไว้เท่านั้น (batch นี้เริ่มหรือเสร็จแล้ว)	ไม่มีอะไรเปลี่ยนแปลง
rate_limited	429	คีย์ทำคำขอมากกว่า 600 ครั้งใน 60 วินาทีที่ผ่านมา	รอ Retry-After วินาที ไม่มีการเรียกเก็บเงิน
server_error	500	เกิดข้อผิดพลาดฝั่งเรา	ลองใหม่ด้วย Idempotency-Key เดิม

กำลังลองใหม่

ข้อผิดพลาด 4xx นอกเหนือจาก 429 ต้องการการเปลี่ยนแปลงคำขอ การส่งคำขอเดิมอีกครั้งจะทำให้เกิดข้อผิดพลาดเดิม
เมื่อได้รับ 429 ให้รอจำนวนวินาทีที่ระบุใน Retry-After
เมื่อได้รับ 5xx หรือเกิดการหมดเวลาของเครือข่าย ให้ลองใหม่ด้วย Idempotency-Key เดิม: หากคำขอแรกได้รับการยอมรับ คุณจะได้รับคำตอบกลับมาแทนที่จะส่งครั้งที่สอง

ก่อนหน้าAPI ราคา ถัดไปขีดจำกัดอัตรา