الوسائط

اعرض الوسائط

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

GEThttps://api.sofia-post.com/api/v1/media

اعرض الوسائط

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

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

اعرض الوسائط

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/media?establishmentId=<establishmentId>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

تُعاد وسائط منشأة الأحدث أولًا، صفحة صفحة: انظر الترقيم.

url لكل وسيط موقّع وتنتهي صلاحيته: احتفظ بـ id، وأعد قراءة الوسيط بـ `GET /v1/media/{id}` حين تحتاج إلى عنوان URL جديد.

التفويضات

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

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

establishmentIdstringمطلوب
المنشأة التي تُقرأ مكتبة وسائطها.
cursorstring
قيمة nextCursor من الصفحة السابقة.
limitnumber
حجم الصفحة، من 1 إلى 100 (الافتراضي 20).

الاستجابة

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

dataobject[]مطلوب
وسائط الصفحة
عرض الخصائص الفرعية
- idstringمطلوب
  معرّف الوسائط، لتمريره في media[].id لمنشور
- typestringمطلوب
  نوع الوسائط
  القيم المسموحة: imagevideo
- urlstringمطلوب
  عنوان موقّع، صالح للنافذة الحالية
- fileNamestringمطلوب
  اسم الملف
- contentTypestringمطلوب
  نوع MIME للملف
- sizenumberمطلوب
  الحجم بالبايت
- createdAtstring<date-time>مطلوب
  وقت إضافة الوسائط
- thumbnailUrlstring
  صورة مصغّرة موقّعة (ملصق الفيديو، مربع الصورة)
nextCursorstring
مرّره كـ ?cursor= للصفحة التالية؛ يغيب في النهاية

هل كانت هذه الصفحة مفيدة؟