حالة الفيديو

يوفر دليل واجهة برمجة التطبيقات هذا نظرة عامة على عملية التحقق من حالة طلبك المجمع.

قد تستغرق الطلبات المجمعة بعض الوقت للمعالجة، وذلك حسب عدد جهات الاتصال في ملف CSV الخاص بك. بعد بدء الطلب، ستحتاج إلى التحقق من حالته لمراقبة التقدم، والذي سيتم توفيره كنسبة مئوية. 🦊

البدء السريع

دعنا نتعمق ونستكشف كيفية التحقق من تقدم طلبك المجمع.

الحصول على حالة

الطلب المجمع للتحقق من تقدم طلبك المجمع، قدم 'id' كـ 'video_id' الذي تم الحصول عليه من إنشاء الطلب أو من خلال واجهة برمجة تطبيقات الإدراج المجمع. ستتلقى استجابةً لذلك:

'progress': التقدم الحالي للطلب كنسبة مئوية.
'status': الحالة العامة للطلب.
'video_links_csv': يحتوي على عناوين URL لتنزيل مقاطع الفيديو. يمكنك استدعاء هذه النقطة النهائية عدة مرات. سيؤدي هذا إلى إرجاع نتائج جزئية بتنسيق csv أيضًا. عند إنشاء مقاطع الفيديو، ستظهر الحالة "قيد التنفيذ" وسيكون التقدم أقل من 100. إذا تم إنشاء جميع مقاطع الفيديو، فستكون الحالة "مكتمل" وسيكون التقدم 100.

طلبالاستجابة (قيد التنفيذ)الرد (مكتمل)

curl --request GET  \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/video/<video_id>'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'

{
    "id": 494,
    "csv_file_name": "my_contacts.csv",
    "progress": 55,
    "status": "in-progress",
    "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_contact_videos.csv"
}

{
    "id": 494,
    "csv_file_name": "my_contacts.csv",
    "progress": 100,
    "status": "Completed",
    "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_contact_videos.csv"
}