Idempotencia

Mantén un UUID por acción y reutilízalo tras un tiempo de espera o reintento. Se rechaza una entrada distinta con el mismo UUID.

Una intención por acción#

HTTP

Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

Las solicitudes REST envuelven los argumentos en input. Las llamadas MCP envían los mismos argumentos directamente.

JSON

{  "_meta": {    "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"  }}

Recuperar tras un tiempo de espera#

Busca la operación original por su intención antes de decidir si reenviar.

curl 'https://platform.tongai.io/v1/operations/by-intent/45be69f1-c266-4a09-a82c-bf3c6303eb03' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuración

curl --version

Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.

Conflicto de intención#

JSON

{  "error": {    "code": "IDEMPOTENCY_CONFLICT",    "message": "This intent was already used for different details.",    "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",    "retryable": false  },  "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8"}

Reutiliza una intención solo con las entradas originales. Usa otro UUID para una acción realmente nueva.