`GET /v1/usage`

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

مثال طلب#

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

الإعدادات

curl --version

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

usage: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"

limitintegerاختياري

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

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

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

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

الاستجابة

JSON

{}

application/json

object

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 وأعد المحاولة بالقصد نفسه. تحقق من العملية المحفوظة بعد انتهاء مهلة.