Skip to main content
تستخدم واجهة برمجة تطبيقات HappyHorse Tasks لاستعلام عن مهام إنشاء أو تحرير الفيديوهات التي تم إنشاؤها بواسطة واجهة برمجة تطبيقات HappyHorse Videos.

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

لاستخدام واجهة برمجة تطبيقات 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 هو عدد المهام المطابقة في هذه المرة.