Idempotencia
Todos los endpoints de mutaciónPOST y PATCH aceptan un encabezado opcional Idempotency-Key.
Cuándo enviarlo
Usa una clave de idempotencia cuando:- Un cliente puede reintentar después de un fallo de transporte.
- Un worker de cola puede despachar la misma operación lógica más de una vez.
- Un agente de IA puede volver a ejecutar una mutación después de un progreso parcial o reintentos de herramienta.
Patrón recomendado
- Genera una clave estable por mutación lógica.
- Reutiliza la misma clave para los reintentos de esa mutación.
- Cambia la clave cuando cambie la mutación prevista.
Ejemplos
Buenos límites
- Una clave para crear un proyecto.
- Una clave diferente para exportar ese proyecto.
- Y otra clave diferente para actualizar la configuración del proyecto.