Idempotencia - wondeya

Los reintentos de red ocurren (una solicitud expira, una función se vuelve a ejecutar), y un reintento a ciegas de una creación crea un segundo agente, o gasta un segundo crédito de chat. Un Idempotency-Key hace que un reintento repita la primera respuesta en su lugar.

Úsalo

Envía cualquier cadena única en cualquier POST bajo /v1; todos lo respetan (creaciones, publicar y despublicar, adiciones de conocimiento, fusiones de temas, subidas de recursos, el turno de chat en JSON):

curl -X POST $WDY/agents \
  -H "Authorization: Bearer $WDY_KEY" \
  -H "Idempotency-Key: a1b2c3-create-support" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Support" }'

Reintenta con la MISMA clave y el MISMO cuerpo, y recibirás de vuelta la primera respuesta, sin cambios, con:

Idempotent-Replayed: true

No se crea un segundo agente, ni se gasta un segundo crédito.

Las reglas

Situación	Resultado
Misma clave, mismo cuerpo	Se repite la primera respuesta (`Idempotent-Replayed: true`).
Misma clave, cuerpo distinto	`422` `wondeya.idempotency.conflict`: una clave nombra una sola solicitud.
Misma clave mientras la primera aún se ejecuta	`409`.
La primera solicitud falló	No se guarda; reintenta con la misma clave sin problema.

Una clave está acotada a tu clave de API y se conserva durante 24 horas. Se respeta en el modo de chat en JSON; un turno en streaming (SSE) no se puede repetir, así que ahí la clave se ignora.