Idempotência

Endpoints POST com efeitos colaterais aceitam um header opcional:

X-Idempotency-Key: <uuid-or-opaque-string>

Replays com a mesma chave dentro de 24h retornam a resposta original, inalterada. Replays com a mesma chave mas um body diferente retornam 409 conflict.

Sempre envie um X-Idempotency-Key em requisições POST para que retries após um timeout ou um 5xx não criem um recurso duplicado. GET, PATCH e DELETE já são naturalmente idempotentes e não precisam de um.

curl https://api.inbox.kobana.com.br/v1/inboxes \
  --cert ./client.crt --key ./client.key \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: $(uuidgen)" \
  -d '{ "label": "Support — Triage" }'