Idempotência

Mantenha um UUID por ação e reutilize após timeout ou nova tentativa. Entradas diferentes com o mesmo UUID são rejeitadas.

Uma intenção por ação#

HTTP

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

As solicitações REST envolvem os argumentos em input. As chamadas MCP enviam os mesmos argumentos diretamente.

JSON

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

Recuperar após tempo limite#

Busque a operação original pela intenção antes de decidir se deve reenviar.

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

Configuração

curl --version

Erros e limites de requisiçõesEntenda os erros, tente novamente com segurança e recupere gerações com falha.Solicitações e registrosUma solicitação aceita não é uma geração concluída. Acompanhe o trabalho até o resultado estar pronto.

Conflito de intenção#

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"}

Reutilize uma intenção apenas com as entradas originais. Use outro UUID para uma nova ação.