คำขอที่ทำซ้ำได้

เครือข่ายล้มเหลว หากคำขอส่งหมดเวลา คุณไม่สามารถทราบได้ว่าคำขอได้รับการยอมรับหรือไม่ ส่ง POST /v1/messages และ POST /v1/batches พร้อมหัวข้อ Idempotency-Key และลองใหม่ด้วยคีย์เดียวกัน

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-55102-shipped" \
  -d '{"to": "+14155550123", "text": "Order 55102 has shipped."}'

กฎ

• คีย์คือสตริงใดๆ ที่มีความยาวไม่เกิน 255 ตัวอักษร ใช้สิ่งที่ระบุเหตุการณ์: รหัสคำสั่งซื้อและขั้นตอน หรือ UUID ที่สร้างก่อนการลองครั้งแรก
• คำขอที่ได้รับการยอมรับ (202) จะถูกจำไว้เป็นเวลา 24 ชั่วโมงต่อบัญชี คีย์เดียวกันกับเนื้อหาเดียวกันจะส่งคำตอบแรกกลับมาอีกครั้ง พร้อมหัวข้อ Idempotent-Replayed: true และไม่ส่งอะไร
• คีย์เดียวกันกับเนื้อหาที่ต่างกันจะตอบกลับ 409 idempotency_conflict
• คำขอที่ล้มเหลวด้วยข้อผิดพลาดจะไม่ถูกจำไว้ ดังนั้นคุณสามารถแก้ไขและลองใหม่ด้วยคีย์เดียวกัน