Idempotence

Conservez un UUID par action et réutilisez-le après un délai ou une nouvelle tentative. Une entrée différente avec le même UUID est refusée.

Une intention par action#

HTTP

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

Les requêtes REST placent les arguments dans input. Les appels MCP envoient ces mêmes arguments directement.

JSON

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

Reprendre après un délai dépassé#

Retrouvez l’opération initiale par son intention avant de décider de la soumettre à nouveau.

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

Configuration

curl --version

Erreurs et limites de débitComprenez les erreurs, réessayez sans risque et reprenez les générations échouées.Requêtes et journauxUne requête acceptée n’est pas une génération terminée. Suivez le travail jusqu’à ce que le résultat soit prêt.

Conflit d’intention#

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

Réutilisez une intention uniquement avec ses entrées initiales. Utilisez un nouvel UUID pour une nouvelle action.