ثبات أثر إعادة الطلب

احتفظ بمعرّف UUID واحد لكل إجراء وأعد استخدامه بعد انتهاء المهلة أو إعادة المحاولة. تُرفض المدخلات المختلفة بالمعرّف نفسه.

قصد واحد لكل إجراء#

HTTP

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

تغلّف طلبات REST معاملات الأداة داخل input. ترسل استدعاءات MCP المعاملات نفسها مباشرة.

JSON

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

الاستئناف بعد انتهاء المهلة#

ابحث عن العملية الأصلية بقصدها قبل اتخاذ قرار إعادة الإرسال.

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

الإعدادات

curl --version

الأخطاء وحدود الطلباتافهم استجابات الأخطاء وأعد المحاولة بأمان واستأنف عمليات التوليد الفاشلة.الطلبات والسجلاتقبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.

تعارض القصد#

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

أعد استخدام القصد بمدخلاته الأصلية فقط. استخدم UUID جديدًا لإجراء جديد فعلًا.