Mga idempotent request

May pagkakamali ang mga network. Kung ang isang request ay nag-timeout, hindi mo malalaman kung ito ay tinanggap. Magpadala ng POST /v1/messages at POST /v1/batches gamit ang Idempotency-Key header, at subukan ulit gamit ang parehong 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."}'

Mga patakaran

• Ang key ay anumang string hanggang 255 karakter. Gumamit ng isang bagay na nagpapangalan sa event: isang order id at step, o isang UUID na ginawa bago ang unang pagsubok.
• Ang isang tinanggap na request (202) ay naaalala sa loob ng 24 oras bawat account. Ang parehong key na may parehong body ay magbabalik ng unang sagot muli, kasama ang header na Idempotent-Replayed: true, at hindi magpapadala ng anuman.
• Ang parehong key na may ibang body ay magbibigay ng sagot na 409 idempotency_conflict.
• Ang mga request na nabigo dahil sa error ay hindi naaalala, kaya maaari mo itong ayusin at subukan ulit gamit ang parehong key.