Idempotência

Nos endpoints de envio (POST /v1/messages/*), use uma chave de idempotência para garantir que um retry seu não gere mensagem duplicada.

Como usar

Envie um UUID v4 no header X-Idempotency-Key:

Envio idempotente

curl -X POST https://api.zapdev.com.br/v1/messages/text \
  -H "Authorization: Bearer zd_live_..." \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: 3f9c1e7a-6b2d-4a1e-9c8f-2b7d5e1a0c34" \
  -d '{ "to": "5511999999999", "text": "Olá!" }'

Comportamento

• A mesma chave, repetida em até 24h, retorna o resultado original, sem reenviar.
• Gere uma chave nova por mensagem lógica (não reaproveite entre mensagens diferentes).
• Recomendado sempre que houver retry automático do seu lado.