Saltar al contenido principal
Las operaciones que descuentan créditos exigen el header Idempotency-Key:
  • POST /classifications
  • POST /classifications/{id}/answers
La clave la elegís vos: de 16 a 128 caracteres, solo letras sin acentos, números, - y _. Usá algo que identifique la operación en tu sistema, como el id del pedido más un sufijo.

​
Cómo funciona

  • Misma clave y mismo cuerpo: devolvemos la misma clasificación, sin crear otra ni descontar otro crédito. La respuesta trae Idempotent-Replayed: true.
  • Misma clave con otro cuerpo: 422 idempotency-key-reused. Si querés otra clasificación, usá otra clave.
  • Misma clave mientras el primer pedido sigue en curso: 409 idempotency-key-in-flight. Esperá y reintentá.
  • Sin clave o con formato inválido: 422 idempotency-key-invalid.
La clave queda atada a su primer pedido y no vence: reusarla días después devuelve la misma clasificación, o 422 idempotency-key-reused si el cuerpo cambió. Usá una clave nueva por cada clasificación.

​
Cuándo reintentar

Si un pedido se cortó por la red o recibiste un 5xx, reintentá con la misma clave. Es la forma segura: si el primero llegó, recibís su resultado; si no, se crea.
No generes una clave nueva en cada reintento. Con una clave nueva, un pedido que sí había llegado crea una segunda clasificación, que también descuenta un crédito.