`POST /v1/requests/exports`

استخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.

مثال طلب#

curl -X POST 'https://platform.tongai.io/v1/requests/exports' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{}'

الإعدادات

curl --version

المصادقة#

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

logs:read

المعاملات#

Idempotency-Keystringمطلوب

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

محتوى الطلب#

application/json

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.

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

الاستجابة

JSON

{}

`HTTP 202`

application/json

idstringاختياري

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

statusJSONاختياري

القيم المسموح بها"queued""running""ready""failed"

rowsintegerاختياري

expires_atstringاختياري

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

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

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 لكل مستخدم متصل استخدام أرصدته.الأخطاء وحدود الطلباتافهم استجابات الأخطاء وأعد المحاولة بأمان واستأنف عمليات التوليد الفاشلة.الطلبات والسجلاتقبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.