الملفات والدفعات
استرداد Batch
يسترد الحالة الحالية والتعدادات وملفات النتائج لـ batch.
نظرة عامة
يُرجع حالة الـ batch، وتعدادات الطلبات، ومعرّفات ملفات النتائج. في حال كان معرّف الـ batch غير معروف، أو تابعًا لـ Workspace آخر، يتم إرجاع 404 batch_not_found.
تكون قيمة status واحدة من: validating، أو queued، أو in_progress، أو finalizing، أو completed، أو failed، أو cancelling، أو cancelled، أو expired. تكون ملفات النتائج جاهزة عندما تصبح قيمة status هي completed؛ يمكنك قراءتها عبر استرداد محتوى الملف.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-H "Authorization: Bearer sk-your-api-key"الاستجابة
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}حقول مهمة
request_countsobject
تعدادات الطلبات الإجمالية والمكتملة والفاشلة والملغاة.
output_file_idstring|null
معرّف ملف النتائج الناجحة.
error_file_idstring|null
معرّف ملف النتائج الفاشلة.
التفويض
BearerAuth AuthorizationBearer <token>
مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
batch_id*string
الاستجابة
application/json
application/json
application/json