Skip to main content
GET
استرداد دفعة
يتطلب الوصول إلى الميزات التجريبية في مساحة العمل. راجع مهام الفيديو والمعالجة على دفعات لمعرفة الإعداد والويب هوك والتعامل مع النتائج.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

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

batch_id
string
مطلوب

معرّف الدفعة المراد استردادها.

الاستجابة

استجابة حالة الدفعة

id
string
native_batch_id
string | null

معرّف الدفعة الأصلي لدى المزوّد عندما يختلف عن معرّف البوابة.

object
string
endpoint
string
errors
object
input_file_id
string
completion_window
string
status
string
lifecycle_status
enum<string>

حالة دورة الحياة غير المتزامنة الموحدة لمستهلكي الاستطلاع وWebSocket وwebhook.

الخيارات المتاحة:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

نسبة إكمال تقريبية للدفعة مشتقة من أعداد طلبات المزوّد عند توفرها. تبلغ الدفعات المكتملة عن 100.

النطاق المطلوب: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

عنوان WebSocket للاشتراك في تحديثات دورة الحياة الموحدة للمهام غير المتزامنة.

cancel_url
string<uri> | null

محجوز للتوافق؛ قيمته حالياً null دائماً.

results_url
string<uri> | null

عنوان تنزيل Phaseo JSONL يتطلب المصادقة للدفعات المدعومة في حالة نهائية. يكون null أثناء المعالجة. قد لا يكون للدفعة النهائية ناتج. استخدم مفتاح API من مساحة العمل المالكة؛ تنطبق حدود الاحتفاظ لدى المزوّد.

output_file_id
string
error_file_id
string
created_at
integer
in_progress_at
integer
expires_at
integer
finalizing_at
integer
completed_at
integer
failed_at
integer
expired_at
integer
cancelling_at
integer
cancelled_at
integer
request_counts
object
metadata
object
request_id
string
provider
string
session_id
string
webhook
object

إعداد webhook غير المتزامن بعد تنقيح البيانات الحساسة مع حالة التسليم. لا تُرجع الأسرار أبداً؛ يشير has_secret إلى تفعيل عمليات التسليم الموقّعة. تتضمن عمليات التسليم الموقّعة ترويسات x-phaseo-signature وx-phaseo-timestamp وx-phaseo-event-id وx-phaseo-event-type وx-phaseo-delivery-key وx-phaseo-attempt وx-phaseo-max-attempts.

next_webhook_retry_at
string | null
last_webhook_progress
number | null
last_webhook_progress_at
string | null
last_webhook_dispatched_at
string | null
finalized_at
string | null
pricing_lines
object[]
usage
object

الاستخدام والتكلفة الإجمالية الموحدة بعد الإنهاء.

billing
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦