مرجع API

الاستعلام عن سجل الفيديو الدائم

GET/v1/videos

يسرد السجلات الدائمة غير المحذوفة فقط للحساب والمفتاح نفسيهما. الفوترة والتخزين مستقلان؛ ولا تضمن قراءة السجل تطبيق سياسة النموذج نفسها المستخدمة في التوليد.

المصادقة والصلاحيات

استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.

Authorization: Bearer $GLOOP_API_KEY

آليات المصادقة: BearerAuth

الطلب

معاملات الاستعلام

  • qstringاختياري

    البحث في التوجيه.

  • modelstringاختياري

    معرّف النموذج العام.

  • statusstringاختياري

    تصفية queued/processing/succeeded/failed/unknown.

  • cursorstringاختياري

    next_cursor من الاستجابة الأصلية.

  • fromintegerاختياري

    حدود زمنية بثواني Unix، ‏from <= to.

    الحد الأدنى
    0
  • tointegerاختياري

    حدود زمنية بثواني Unix، ‏from <= to.

    الحد الأدنى
    0
  • limitintegerاختياري

    عدد العناصر في الصفحة.

    القيمة الافتراضية
    20
    الحد الأدنى
    1
    الحد الأقصى
    50

الاستجابات والأخطاء

HTTP 200

تم الاستعلام عن سجل الفيديو الدائم بنجاح

application/json

النوع
object
الحقول المطلوبة
data
  • dataarrayمطلوب

    مصفوفة بيانات الصفحة/الدليل الحاليين.

    الحقول الفرعية لـ data (1)
    • []objectاختياري
      الحقول الفرعية لـ [] (12)
      • updated_atintegerاختياري

        آخر تحديث بثواني Unix.

      • retentionstringاختياري

        سياسة الاحتفاظ بنتائج المهمة؛ persistent يعني مساحة العمل الدائمة.

      • inputobjectاختياري

        مدخلات المهمة الأصلية أو مدخلات عقد الأداة.

        الحقول الفرعية لـ input (14)
        • modestringاختياري

          مطلوب في persistent.

          القيم المعدودة
          ["text_to_video","image_to_video"]
        • retentionstringاختياري

          يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

        • quote_idstringاختياري

          يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

        • start_frameobjectاختياري

          مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

          الحقول الفرعية لـ start_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • end_frameobjectاختياري

          إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

          الحقول الفرعية لـ end_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • webhook_endpoint_idstringاختياري

          يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

        • modelstringمطلوب

          معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

        • promptstringمطلوب

          توجيه التوليد.

          الحد الأدنى للطول
          1
          الحد الأقصى للطول
          2500
        • durationintegerاختياري

          مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

        • image_urlstringاختياري

          إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • end_image_urlstringاختياري

          إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • resolutionstringاختياري

          قيمة الدقة في الإعداد المسبق للنموذج.

        • aspect_ratiostringاختياري

          قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

        • generate_audiobooleanاختيارييسمح بـ null

          يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: model, prompt

        خصائص إضافية: false

        • modestringاختياري

          مطلوب في persistent.

          القيم المعدودة
          ["text_to_video","image_to_video"]
        • retentionstringاختياري

          يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

        • quote_idstringاختياري

          يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

        • start_frameobjectاختياري

          مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

          الحقول الفرعية لـ start_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • end_frameobjectاختياري

          إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

          الحقول الفرعية لـ end_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • webhook_endpoint_idstringاختياري

          يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

        • modelstringمطلوب

          معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

        • promptstringمطلوب

          توجيه التوليد.

          الحد الأدنى للطول
          1
          الحد الأقصى للطول
          2500
        • durationintegerاختياري

          مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

        • image_urlstringاختياري

          إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • end_image_urlstringاختياري

          إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • resolutionstringاختياري

          قيمة الدقة في الإعداد المسبق للنموذج.

        • aspect_ratiostringاختياري

          قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

        • generate_audiobooleanاختيارييسمح بـ null

          يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

      • billingobjectاختياري

        حالة الفوترة المستقلة؛ لا تستبدلها بحالة التوليد.

        الحقول الفرعية لـ billing (7)
        • currencystringمطلوب

          عملة عرض السعر/الفوترة.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • reserved_quotaintegerمطلوب

          الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

        • final_quotaintegerمطلوبيسمح بـ null

          التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

        • reserved_amountstringمطلوب

          الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

        • final_amountstringمطلوبيسمح بـ null

          الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

        • currencystringمطلوب

          عملة عرض السعر/الفوترة.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • reserved_quotaintegerمطلوب

          الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

        • final_quotaintegerمطلوبيسمح بـ null

          التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

        • reserved_amountstringمطلوب

          الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

        • final_amountstringمطلوبيسمح بـ null

          الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

      • storageobjectاختياري

        حالة حفظ الملف المستقلة.

        الحقول الفرعية لـ storage (3)
        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: status

        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

      • availabilityobjectاختياري

        الإجراءات المتاحة حاليًا.

        الحقول الفرعية لـ availability (4)
        • can_cancelbooleanمطلوب

          هل تسمح المهمة الحالية بطلب الإلغاء.

        • can_deletebooleanمطلوب

          هل تسمح المهمة الحالية بالحذف.

        • can_retry_storagebooleanمطلوب

          هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

        • reasonstringاختياري

          السبب العام لتعذر الإجراء أو مراجعة الحسابات.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: can_cancel, can_delete, can_retry_storage

        • can_cancelbooleanمطلوب

          هل تسمح المهمة الحالية بطلب الإلغاء.

        • can_deletebooleanمطلوب

          هل تسمح المهمة الحالية بالحذف.

        • can_retry_storagebooleanمطلوب

          هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

        • reasonstringاختياري

          السبب العام لتعذر الإجراء أو مراجعة الحسابات.

      • idstringمطلوب

        المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.

      • modelstringمطلوب

        معرّف نموذج عام من دليل المفتاح الحالي.

      • statusstringمطلوب

        حالة المهمة العادية أو الدائمة؛ قد تكون pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. لا تعني الحالة النهائية تسوية الفوترة أو جاهزية الأرشفة.

      • created_atintegerمطلوب

        وقت الإنشاء بثواني Unix.

      • resultobjectاختياري

        بيانات وصفية للنتائج الجاهزة؛ قد لا تتوفر قبل الاكتمال.

        الحقول الفرعية لـ result (8)
        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • storage_statusstringاختياري

          حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

        • deliverystringاختياري

          يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

        • content_pathstringاختياري

          مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

        • urlstringاختياري

          رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

        • content_typestringاختياري

          نوع MIME للنتيجة.

        • file_namestringاختياري

          اسم الملف العام للتنزيل.

        • file_sizeintegerاختياري

          حجم ملف النتيجة بالبايت.

        فرع allOf رقم 1

        النوع: object

        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • storage_statusstringاختياري

          حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

        • deliverystringاختياري

          يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

        • content_pathstringاختياري

          مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

        • urlstringاختياري

          رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

        • content_typestringاختياري

          نوع MIME للنتيجة.

        • file_namestringاختياري

          اسم الملف العام للتنزيل.

        • file_sizeintegerاختياري

          حجم ملف النتيجة بالبايت.

      • errorstringاختياري

        فئة فشل أو كائن خطأ عام.

      فرع allOf رقم 1

      النوع: object

      المطلوب في هذا الفرع: id, model, status, created_at

      • updated_atintegerاختياري

        آخر تحديث بثواني Unix.

      • retentionstringاختياري

        سياسة الاحتفاظ بنتائج المهمة؛ persistent يعني مساحة العمل الدائمة.

      • inputobjectاختياري

        مدخلات المهمة الأصلية أو مدخلات عقد الأداة.

        الحقول الفرعية لـ input (14)
        • modestringاختياري

          مطلوب في persistent.

          القيم المعدودة
          ["text_to_video","image_to_video"]
        • retentionstringاختياري

          يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

        • quote_idstringاختياري

          يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

        • start_frameobjectاختياري

          مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

          الحقول الفرعية لـ start_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • end_frameobjectاختياري

          إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

          الحقول الفرعية لـ end_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • webhook_endpoint_idstringاختياري

          يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

        • modelstringمطلوب

          معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

        • promptstringمطلوب

          توجيه التوليد.

          الحد الأدنى للطول
          1
          الحد الأقصى للطول
          2500
        • durationintegerاختياري

          مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

        • image_urlstringاختياري

          إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • end_image_urlstringاختياري

          إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • resolutionstringاختياري

          قيمة الدقة في الإعداد المسبق للنموذج.

        • aspect_ratiostringاختياري

          قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

        • generate_audiobooleanاختيارييسمح بـ null

          يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: model, prompt

        خصائص إضافية: false

        • modestringاختياري

          مطلوب في persistent.

          القيم المعدودة
          ["text_to_video","image_to_video"]
        • retentionstringاختياري

          يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

        • quote_idstringاختياري

          يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

        • start_frameobjectاختياري

          مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

          الحقول الفرعية لـ start_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • end_frameobjectاختياري

          إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

          الحقول الفرعية لـ end_frame (1)
          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

          فرع allOf رقم 1

          النوع: object

          المطلوب في هذا الفرع: file_id

          • file_idstringمطلوب

            المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • webhook_endpoint_idstringاختياري

          يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

        • modelstringمطلوب

          معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

        • promptstringمطلوب

          توجيه التوليد.

          الحد الأدنى للطول
          1
          الحد الأقصى للطول
          2500
        • durationintegerاختياري

          مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

        • image_urlstringاختياري

          إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • end_image_urlstringاختياري

          إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

        • resolutionstringاختياري

          قيمة الدقة في الإعداد المسبق للنموذج.

        • aspect_ratiostringاختياري

          قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

        • generate_audiobooleanاختيارييسمح بـ null

          يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

      • billingobjectاختياري

        حالة الفوترة المستقلة؛ لا تستبدلها بحالة التوليد.

        الحقول الفرعية لـ billing (7)
        • currencystringمطلوب

          عملة عرض السعر/الفوترة.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • reserved_quotaintegerمطلوب

          الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

        • final_quotaintegerمطلوبيسمح بـ null

          التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

        • reserved_amountstringمطلوب

          الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

        • final_amountstringمطلوبيسمح بـ null

          الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

        • currencystringمطلوب

          عملة عرض السعر/الفوترة.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • reserved_quotaintegerمطلوب

          الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

        • final_quotaintegerمطلوبيسمح بـ null

          التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

        • reserved_amountstringمطلوب

          الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

        • final_amountstringمطلوبيسمح بـ null

          الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

      • storageobjectاختياري

        حالة حفظ الملف المستقلة.

        الحقول الفرعية لـ storage (3)
        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: status

        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • statusstringمطلوب

          حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

        • error_codestringاختياري

          رمز خطأ عام يمكن استخدامه في منطق التفرّع.

      • availabilityobjectاختياري

        الإجراءات المتاحة حاليًا.

        الحقول الفرعية لـ availability (4)
        • can_cancelbooleanمطلوب

          هل تسمح المهمة الحالية بطلب الإلغاء.

        • can_deletebooleanمطلوب

          هل تسمح المهمة الحالية بالحذف.

        • can_retry_storagebooleanمطلوب

          هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

        • reasonstringاختياري

          السبب العام لتعذر الإجراء أو مراجعة الحسابات.

        فرع allOf رقم 1

        النوع: object

        المطلوب في هذا الفرع: can_cancel, can_delete, can_retry_storage

        • can_cancelbooleanمطلوب

          هل تسمح المهمة الحالية بطلب الإلغاء.

        • can_deletebooleanمطلوب

          هل تسمح المهمة الحالية بالحذف.

        • can_retry_storagebooleanمطلوب

          هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

        • reasonstringاختياري

          السبب العام لتعذر الإجراء أو مراجعة الحسابات.

      • idstringمطلوب

        المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.

      • modelstringمطلوب

        معرّف نموذج عام من دليل المفتاح الحالي.

      • statusstringمطلوب

        حالة المهمة العادية أو الدائمة؛ قد تكون pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. لا تعني الحالة النهائية تسوية الفوترة أو جاهزية الأرشفة.

      • created_atintegerمطلوب

        وقت الإنشاء بثواني Unix.

      • resultobjectاختياري

        بيانات وصفية للنتائج الجاهزة؛ قد لا تتوفر قبل الاكتمال.

        الحقول الفرعية لـ result (8)
        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • storage_statusstringاختياري

          حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

        • deliverystringاختياري

          يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

        • content_pathstringاختياري

          مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

        • urlstringاختياري

          رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

        • content_typestringاختياري

          نوع MIME للنتيجة.

        • file_namestringاختياري

          اسم الملف العام للتنزيل.

        • file_sizeintegerاختياري

          حجم ملف النتيجة بالبايت.

        فرع allOf رقم 1

        النوع: object

        • file_idstringاختياري

          المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

        • storage_statusstringاختياري

          حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

        • deliverystringاختياري

          يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

        • content_pathstringاختياري

          مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

        • urlstringاختياري

          رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

        • content_typestringاختياري

          نوع MIME للنتيجة.

        • file_namestringاختياري

          اسم الملف العام للتنزيل.

        • file_sizeintegerاختياري

          حجم ملف النتيجة بالبايت.

      • errorstringاختياري

        فئة فشل أو كائن خطأ عام.

  • next_cursorstringاختياري

    مؤشر الصفحة التالية؛ مرّره كما هو لمعامل التقليب، والفارغ يعني الصفحة الأخيرة.

HTTP 400

حقول الطلب أو معاملاته غير صالحة.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 401

Key مفقود أو غير صالح أو منتهي أو ملغى.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 403

صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 404

الكائن/الإمكانية غير متاحين، أو مفتاح الميزة معطّل.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 409

تعارض في منع التكرار/عرض السعر، أو كائن غير جاهز، أو ما يزال مشارًا إليه.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 429

حد معدل الطلبات/قائمة الانتظار.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 500

فشل داخلي في المصادقة أو تخزين البيانات.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 503

الخدمة أو التسعير أو التخزين غير متاح.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)