`GET /v1/requests/export`

اقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.

مثال طلب#

curl 'https://platform.tongai.io/v1/requests/export' \  -H "Authorization: Bearer $TONG_API_KEY"

الإعدادات

curl --version

المصادقة#

استخدم مفتاح API على الخادم لحسابك، أو OAuth لحساب كل عميل. لا ترسل المفاتيح في المطالبات أو وسيطات الأدوات.

logs:read

المعاملات#

fromstringاختياري

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

tostringاختياري

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

channelstringاختياري

القيم المسموح بها"api""mcp"

credential_idstringاختياري

معرّف سداسي عشري من 24 محرفًا.

toolstringاختياري

الحد الأدنى للطول: 1 محرفًا.

الحد الأقصى للطول: 100 محرفًا.

modelstringاختياري

اختر معرّف نموذج Tong عامًا من الاكتشاف الحالي.

الحد الأدنى للطول: 1 محرفًا.

الحد الأقصى للطول: 150 محرفًا.

categorystringاختياري

الحد الأدنى للطول: 1 محرفًا.

الحد الأقصى للطول: 60 محرفًا.

statestringاختياري

القيم المسموح بها"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringاختياري

الحد الأقصى للطول: 150 محرفًا.

activitystringاختياري

القيم المسموح بها"creative""all"

outcomestringاختياري

القيم المسموح بها"success""error""pending""cancelled"

beforestringاختياري

معرّف UUID، مثل e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

limitintegerاختياري

الحد الأدنى: 1.

الحد الأقصى: 100.

القيمة الافتراضية: 40.

محتوى الطلب#

لا يوجد محتوى طلب لهذه النقطة.

مخطط الاستجابة#

الاستجابة

HTTP

HTTP/1.1 200 OKContent-Type: text/csv

text/csv

request_id,created_at,channel,method,route,http_status,duration_ms,operation_id,tool,model,operation_status,usage_credits,wallet_debited_credits"e8aa0a87-6cd9-42eb-975a-b72bf43218c8","2026-10-22T09:00:00.000Z","api","GET","/v1/models","200","12","","","","","",""

`HTTP 200`

text/csv

string

الأخطاء والحدود#

HTTP	الخطأ	الاستئناف
`400`	طلب غير صالح`REQUEST_INVALID`	صحح الحقول المشار إليها في الخطأ قبل إعادة المحاولة.
`401`	بيانات اعتماد غير صالحة`CREDENTIAL_INVALID`	تحقق من بيانات الاعتماد وانتهائها وما إذا أُلغيت.
`402`	أرصدة غير كافية`INSUFFICIENT_CREDITS`	أضف أرصدة إلى الحساب المالك لبيانات الاعتماد ثم تابع العمل المحفوظ.
`403`	الإذن مرفوض`SCOPE_REQUIRED`	استخدم بيانات اعتماد بالأذونات المطلوبة والوصول إلى المورد المحدد.
`404`	المورد غير متاح`RESOURCE_UNAVAILABLE`	تحقق من معرّف المورد وملكيته للحساب المصرح له.
`409`	تعارض القصد`IDEMPOTENCY_CONFLICT`	أعد استخدام القصد مع طلبه الأصلي فقط. استخدم UUID جديدًا لإجراء مختلف.
`429`	تم بلوغ حد الطلبات`RATE_LIMITED`	انتظر المدة المحددة في Retry-After قبل إعادة الطلب نفسه.
`503`	غير متاح مؤقتًا`DEPENDENCY_UNAVAILABLE`	انتظر Retry-After وأعد المحاولة بالقصد نفسه. تحقق من العملية المحفوظة بعد انتهاء مهلة.

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