التوثيق

مرجع API

الحصول على رابط تنزيل ملف قصير الصلاحية

GET/v1/files/{file_id}/download-url

الملفات السابقة للحساب والمفتاح نفسيهما. يُسمح بالمفاتيح الصالحة ذات الحصة المستنفدة؛ وتُرفض المفاتيح الملغاة/المنتهية الصلاحية. يتطلب التنزيل ready؛ ويُرجع الحذف أثناء وجود مرجع 409. يعيد retry محاولة حفظ النتيجة الأصلية فقط، لا التوليد. تستخدم API العادية احتفاظًا بالأيام، وتحمي المهام الدائمة المراجع، ويعني expires_at=0 عدم وجود انتهاء صلاحية ثابت.

التشغيل والتنزيل

اقرأ حالة الملف أولًا ثم اطلب رابط تنزيل مؤقتًا. إذا لم يكن التخزين ready فإن الحصول على الرابط لا يجعل الملف متاحًا مبكرًا. أرسل Key الأصلي إلى GloopAPI فقط، ولا ترفقه عند التنزيل من عنوان HTTPS المُعاد.

يستخدم الفيديو الدائم روابط مؤقتة لتخزين الكائنات لدعم تشغيل Range الأصلي. يختلف GET الكامل لمسار content في الفيديو العادي عن نقل المشغّل هذا. عند انتهاء الرابط احصل على عنوان جديد؛ أما إذا انتهى الملف أو حُذف فلا يعيده تحديث الرابط.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

  • file_idstringمطلوب

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

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

HTTP 200

تم الحصول على رابط تنزيل الملف قصير الصلاحية بنجاح

application/json

النوع
object
الحقول المطلوبة
urlexpires_at
  • urlstringمطلوب

    رابط تنزيل موقّع قصير الصلاحية؛ لا تكشفه أو تحتفظ به طويلًا.

    التنسيق
    "uri"
  • expires_atintegerمطلوب

    ثواني Unix.

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)