Idempotencia

Los endpoints POST con efectos secundarios aceptan un header opcional:

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

Las repeticiones con la misma clave dentro de 24h devuelven la respuesta original, sin cambios. Las repeticiones con la misma clave pero un body diferente devuelven 409 conflict.

Envía siempre un X-Idempotency-Key en las solicitudes POST para que los reintentos tras un timeout o un 5xx no creen un recurso duplicado. GET, PATCH y DELETE son naturalmente idempotentes y no lo necesitan.

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