Tham chiếu

Yêu cầu idempotent

Mạng có thể lỗi. Nếu yêu cầu gửi bị timeout, bạn không biết nó đã được chấp nhận chưa. Gửi POST /v1/messages và POST /v1/batches với header Idempotency-Key, rồi thử lại với cùng 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."}'

Quy tắc

Key là bất kỳ chuỗi nào tối đa 255 ký tự. Dùng tên sự kiện: ID đơn hàng và bước, hoặc UUID tạo trước lần thử đầu.
Yêu cầu được chấp nhận (202) được nhớ trong 24h/tài khoản. Cùng key và nội dung trả về kết quả đầu, với header Idempotent-Replayed: true và không gửi lại.
Cùng key với nội dung khác trả về 409 idempotency_conflict.
Yêu cầu lỗi không được nhớ, nên bạn có thể sửa và thử lại với cùng key.

TrướcGiới hạn truy cập Tiếp theoMẫu code