Idempotencia
Envía una cabecera `Idempotency-Key` en cada creación. Sin ella, un timeout de red seguido del reintento que tu cliente HTTP hace por su cuenta produce una segunda publicación.
Cómo funciona
Idempotency-KeyHeader
Idempotency-Key: 7c9e6679-7425-40de-944b-e07fc1f90ae7La clave se recuerda 24 horas, asociada a tu cuenta y al cuerpo exacto de la petición.
Qué devuelve una repetición
- Misma clave, mismo cuerpo, ya terminada: se devuelve la respuesta original y no se crea nada nuevo.
- Misma clave mientras la primera petición sigue en curso:
409. Reintenta en un momento. - Misma clave, cuerpo distinto:
422. Devolver la primera respuesta para otra petición sería peor que rechazarla.
Solo se recuerda una creación completada. Una petición rechazada por validación no, así que corregir el cuerpo y reenviarlo con la misma clave funciona.