عملية التقديم
لاستخدام واجهة برمجة تطبيقات HappyHorse Videos، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، احتفظ به للاستخدام لاحقًا.
إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء سيتم العودة تلقائيًا إلى الصفحة الحالية.
يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثائق الكاملة: HappyHorse Videos API →
مثال على الطلب
يمكن استخدام واجهة برمجة تطبيقات HappyHorse Tasks لاستعلام نتائج واجهة برمجة تطبيقات HappyHorse Videos.إعداد رأس الطلب وجسم الطلب
رؤوس الطلب تشمل:accept: تحديد استلام نتائج الاستجابة بتنسيق JSON، هنا يتم ملؤه بـapplication/json.authorization: مفتاح استدعاء API، يمكن اختياره مباشرة بعد التقديم.
id: معرف المهمة التي تريد الاستعلام عنها.action: طريقة إجراء العملية على المهمة، يتم ملءretrieveللاستعلام الفردي.
مثال على كود CURL
مثال على الاستجابة
بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع تفاصيل تلك المهمة. حيث أن حقلrequest هو جسم الطلب عند إنشاء المهمة، وحقل response هو جسم الاستجابة الذي يتم إرجاعه بعد إكمال المهمة، على سبيل المثال:
id: معرف المهمة التي تم إنشاؤها، يستخدم لتحديد هذه المهمة بشكل فريد.request: معلومات الطلب عند إنشاء المهمة.response: المعلومات الحالية أو النهائية للعودة من المهمة.created_at: وقت إنشاء المهمة، طابع زمني Unix (ثوانٍ، عائم).started_at: وقت بدء تنفيذ المهمة، طابع زمني Unix (ثوانٍ، عائم).finished_at: وقت إكمال المهمة، طابع زمني Unix (ثوانٍ، عائم). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.elapsed: الوقت المستغرق لتنفيذ المهمة، بوحدة الثواني (عائم، يحتفظ بـ 3 أرقام عشرية). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.
عملية الاستعلام الجماعي
عند استعلام تفاصيل المهام لعدة معرفات مهام، يتم تعيينaction إلى retrieve_batch، ويتم تمرير مصفوفة معرفات المهام عبر ids:
items و count، حيث أن items هي مصفوفة تفاصيل المهام، و count هو عدد المهام المطابقة في هذه المرة.
