الملفات والدفعات

إلغاء Batch

إلغاء batch لم يكتمل بعد.

POST
/v1/batches/{batch_id}/cancel

اطلب إلغاء batch قيد الانتظار أو قيد التشغيل. تحتوي الاستجابة على حالته الحالية: قد يكون الإلغاء لا يزال قيد التنفيذ أو قد اكتمل بالفعل. يحتفظ الـ batch الذي انتهى بالفعل بحالته النهائية الحالية. إذا لم تكن الحالة المُرجعة نهائية، فاسترجع الـ batch مرة أخرى للتحقق من النتيجة. يُرجع معرّف batch غير معروف الخطأ 404 batch_not_found.

الطلب

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches/batch_abc123/cancel" \
  -H "Authorization: Bearer sk-your-api-key"

الاستجابة

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "status": "cancelling",
  "input_file_id": "file_abc123"
}
idstring
معرّف الـ Batch.
statusstring
حالة الـ batch الحالية. لا تفترض أن كل طلب إلغاء ناجح يُرجع cancelling.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات المسار

batch_id*string

الاستجابة

application/json

application/json

application/json