Solicitudes idempotentes

Las redes fallan. Si una solicitud de envío se agota el tiempo, no puedes saber si fue aceptada. Envía POST /v1/messages y POST /v1/batches con un encabezado Idempotency-Key, y reintenta con la misma clave.

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

Reglas

• Una clave es cualquier cadena de hasta 255 caracteres. Usa algo que nombre el evento: un ID de pedido y paso, o un UUID generado antes del primer intento.
• Una solicitud aceptada (202) se recuerda durante 24 horas por cuenta. La misma clave con el mismo cuerpo devuelve la primera respuesta nuevamente, con el encabezado Idempotent-Replayed: true, y no envía nada.
• La misma clave con un cuerpo diferente responde 409 idempotency_conflict.
• Las solicitudes que fallan con un error no se recuerdan, por lo que puedes corregirlas y reintentar con la misma clave.