Richieste idempotenti

Le reti falliscono. Se una richiesta di invio va in timeout, non puoi sapere se è stata accettata. Invia POST /v1/messages e POST /v1/batches con un'intestazione Idempotency-Key e riprova con la stessa chiave.

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."}'

Regole

• Una chiave è qualsiasi stringa fino a 255 caratteri. Usa qualcosa che identifichi l'evento: un ID ordine e passo, o un UUID generato prima del primo tentativo.
• Una richiesta accettata (202) viene ricordata per 24 ore per account. La stessa chiave con lo stesso corpo restituisce nuovamente la prima risposta, con l'intestazione Idempotent-Replayed: true, senza inviare nulla.
• La stessa chiave con un corpo diverso risponde con 409 idempotency_conflict.
• Le richieste che falliscono con un errore non vengono ricordate, quindi puoi correggerle e riprovare con la stessa chiave.