الملفات والدفعات
استرجاع الدفعة (Retrieve Batch)
استرجاع الحالة الحالية، والعدد الإجمالي، وملفات النتائج الخاصة بدفعة معينة.
نظرة عامة
إرجاع حالة الدفعة، وعدد الطلبات المكتملة والفاشلة، ومعرفات ملفات النتائج.
الطلب
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