عملية التقديم
لاستخدام واجهة برمجة تطبيقات إنشاء مقاطع فيديو جمنيس، يجب أولاً الذهاب إلى وحدة التحكم في سحابة بيانات آيس للحصول على رمز 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للاستعلام الجماعي.

