مرجع API

استيراد صورة مرجعية عبر HTTPS

POST/v1/image-assets/import

عند تعطيل الرفع يعيد المسار 404 مباشرةً. كائن JSON واحد دون حقول مجهولة، وبحد 8192 بايت. لا يُعد الاستيراد الفاشل أو غير الجاهز إعادة محاولة للتوليد.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

ترويسات الطلب

  • Idempotency-Keystringمطلوب

    احتفظ بقصد الطلب الأصلي وبالمفتاح نفسه. بعد انقطاع الشبكة، استعلم عن الاسترداد أولًا؛ ولا تُعِد إرسال الحالات غير المعروفة دون تحقق.

    الحد الأدنى للطول
    1
    الحد الأقصى للطول
    191

جسم الطلب · application/json

النوع
object
الحقول المطلوبة
url
خصائص إضافية
false

جسم الطلب مطلوب

  • urlstringمطلوب

    رابط HTTPS عام للصورة، يخضع لفحص SSRF ومحتوى الصورة.

    التنسيق
    "uri"

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

HTTP 200

تم استيراد الصورة المرجعية عبر HTTPS بنجاح

application/json

النوع
object
الحقول المطلوبة
idmime_typesize_byteswidthheightexpires_at
  • file_idstringاختياري

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

  • idstringمطلوب

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

  • mime_typestringمطلوب

    نوع MIME المتحقق منه للملف.

  • size_bytesintegerمطلوب

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

  • widthintegerمطلوب

    عرض الصورة بالبكسل.

  • heightintegerمطلوب

    ارتفاع الصورة بالبكسل.

  • expires_atintegerمطلوب

    ثواني Unix؛ تعني 0 عدم وجود انتهاء ثابت. يرتبط الرفع بملف مستضاف؛ تتطلب القراءة الحساب نفسه وKey نفسه.

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)