Solicitações idempotentes

Redes falham. Se uma solicitação de envio atingir o timeout, você não pode saber se foi aceita. Envie POST /v1/messages e POST /v1/batches com um cabeçalho Idempotency-Key e tente novamente com a mesma chave.

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

Regras

• Uma chave é qualquer string de até 255 caracteres. Use algo que nomeie o evento: um ID de pedido e etapa, ou um UUID criado antes da primeira tentativa.
• Uma solicitação aceita (202) é lembrada por 24 horas por conta. A mesma chave com o mesmo corpo retorna a primeira resposta novamente, com o cabeçalho Idempotent-Replayed: true, e não envia nada.
• A mesma chave com um corpo diferente responde com 409 idempotency_conflict.
• Solicitações que falham com um erro não são lembradas, então você pode corrigi-las e tentar novamente com a mesma chave.