Skip to main content
الوظيفة الرئيسية لواجهة برمجة تطبيقات مهام جمنيس هي استعلام حالة تنفيذ المهمة من خلال إدخال معرف المهمة الذي تم إنشاؤه بواسطة واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس. ستتناول هذه الوثيقة تفاصيل تكامل واجهة برمجة تطبيقات مهام جمنيس، لمساعدتك في دمج واستعلام حالة تنفيذ مهام واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس بسهولة.

عملية التقديم

لاستخدام واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس، يجب أولاً الذهاب إلى وحدة التحكم في سحابة بيانات آيس للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم العودة تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثائق الكاملة: واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس →

مثال على الطلب

يمكن استخدام واجهة برمجة تطبيقات مهام جمنيس لاستعلام نتائج واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس.

إعداد رأس الطلب وجسم الطلب

رؤوس الطلب تشمل:
  • accept: تحديد استلام نتائج الاستجابة بتنسيق JSON، هنا يتم ملؤه بـ application/json.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
جسم الطلب يشمل:
  • id: معرف المهمة المراد استعلامها.
  • action: طريقة تنفيذ العملية على المهمة، يتم ملء retrieve للاستعلام الفردي.

مثال على كود CURL

مثال على الاستجابة

بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع تفاصيل المهمة هنا. حيث أن حقل request هو جسم الطلب عند بدء المهمة، وحقل response هو جسم الاستجابة الذي يتم إرجاعه بعد إكمال المهمة، على سبيل المثال:
تقديم الحقول كما يلي:
  • id: معرف المهمة التي تم إنشاؤها، يستخدم لتحديد هذه المهمة بشكل فريد.
  • request: معلومات الطلب في المهمة المستعلم عنها.
  • response: معلومات الاستجابة في المهمة المستعلم عنها.
  • created_at: وقت إنشاء المهمة، طابع زمني Unix (ثوانٍ، عائم).
  • started_at: وقت بدء تنفيذ المهمة، طابع زمني Unix (ثوانٍ، عائم).
  • finished_at: وقت إكمال المهمة، طابع زمني Unix (ثوانٍ، عائم). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.
  • elapsed: الوقت المستغرق لتنفيذ المهمة، بوحدة الثواني (عائم، يحتفظ بـ 3 أرقام عشرية). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.

عمليات الاستعلام الجماعي

عند استعلام تفاصيل المهام لعدة معرفات مهام، يتم تعيين action إلى retrieve_batch، ويتم تمرير مصفوفة معرفات المهام عبر ids: جسم الطلب يشمل:
  • ids: مصفوفة معرفات المهام المراد استعلامها.
  • action: طريقة تنفيذ العملية على المهمة، يتم ملء retrieve_batch للاستعلام الجماعي.