الوسائطاعرض الوسائط
العودة إلى Sofia

الوسائط

اعرض الوسائط

يسرد مكتبة وسائط منشأة، الأحدث أولًا، صفحة بصفحة، بروابط موقّعة للنافذة الحالية. يعمل في الوضعين الاختباري والفعلي.

GEThttps://api.sofia-post.com/api/v1/media
GET/v1/media
curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

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

  • establishmentIdstringمطلوب

    المنشأة التي تُقرأ مكتبة وسائطها.

  • cursorstring

    قيمة nextCursor من الصفحة السابقة.

  • limitnumber

    حجم الصفحة، من 1 إلى 100 (الافتراضي 20).

الاستجابة

200application/json

صفحة وسائط، مع nextCursor عند وجود المزيد.

  • dataobject[]مطلوب

    وسائط الصفحة

    عرض الخصائص الفرعية
    • idstringمطلوب

      معرّف الوسائط، لتمريره في media[].id لمنشور

    • typestringمطلوب

      نوع الوسائط

      القيم المسموحة: imagevideo

    • urlstringمطلوب

      عنوان موقّع، صالح للنافذة الحالية

    • fileNamestringمطلوب

      اسم الملف

    • contentTypestringمطلوب

      نوع MIME للملف

    • sizenumberمطلوب

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

    • createdAtstring<date-time>مطلوب

      وقت إضافة الوسائط

    • thumbnailUrlstring

      صورة مصغّرة موقّعة (ملصق الفيديو، مربع الصورة)

  • nextCursorstring

    مرّره كـ ?cursor= للصفحة التالية؛ يغيب في النهاية

400

invalid_cursor، أو invalid_request.

404

establishment_not_found: خارج نطاق وصول الرمز.

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.