تخطَّ إلى المحتوى

سرد الوسائط

GET /public/v1/media

يعيد الصور والفيديوهات الموجودة في مكتبة الوسائط، لتستخدم أحدها في منشور بدل رفعه من جديد. ويحمل كل ملف id وpath اللذين يحتاجهما إنشاء منشور، وهما الزوج نفسه الذي يعيده رفع ملف والرفع من عنوان.

إن كنت تفعل ذلك من التطبيق، فراجع مكتبة الوسائط. وهذه العملية متاحة أيضًا بالأداة mediaListTool في خادم MCP من شارك، ولا يقابلها أمر في أداة CLI.

المعامل مطلوب الوصف
page لا رقم الصفحة، يبدأ من 1. والقيمة الافتراضية 1. ويجب أن يكون 1 أو أكبر.
search لا جزء من الاسم الأصلي للملف. ولا فرق بين الأحرف الكبيرة والصغيرة.

وتبدأ page هنا من 1، بخلاف سرد الإشعارات التي تبدأ من صفر، لذا يرفض page=0.

الصفحة الأولى:

Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/media

الصفحة الثانية من الملفات التي يحتوي اسمها الأصلي على logo:

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/media?page=2&search=logo"
{
"pages": 3,
"results": [
{
"id": "media-id",
"name": "a1b2c3d4e5.png",
"originalName": "launch-logo.png",
"path": "https://media.example.com/a1b2c3d4e5.png",
"createdAt": "2026-09-01T10:00:00.000Z"
}
]
}
الحقل الوصف
pages عدد الصفحات إجمالًا، ولا يحسب فيه إلا الملفات التي تطابق search.
results صفحة الملفات، الأحدث أولًا، حتى 32 ملفًا.
id معرف الوسائط، لمصفوفة image في المنشور.
name الاسم المولد الذي خزن شارك الملف به.
originalName اسم ملفك نفسه حين رفعته من التطبيق. وnull حين لم يحفظ اسم، وهذا حال كل ملف مرفوع عبر API.
path عنوان الملف، لمصفوفة image في المنشور.
createdAt متى أضيف الملف.

وبخلاف استجابات الرفع، لا يحمل الملف المسرود thumbnail ولا alt.

ولإعادة استخدام ملف، خذ id وpath الخاصين به إلى مصفوفة image في المنشور:

"image": [ { "id": "media-id", "path": "https://media.example.com/a1b2c3d4e5.png" } ]
الاستجابة المعنى
400 تحقق من الحقول قيمة page أقل من 1، أو ليست رقمًا.
  • 32 ملفًا في كل صفحة، الأحدث أولًا. وحجم الصفحة ثابت؛ فلا يوجد معامل limit.
  • البحث لا يجد أبدًا ملفًا مرفوعًا عبر API. فـ search ينظر في originalName وحده، لا في name المخزن، وتلك الملفات لا يحفظ لها اسم أصلي. ولإيجاد أحدها مجددًا، احتفظ بـ id الذي أعاده رفعه، أو تصفح الصفحات دون search.
  • تجاوز آخر صفحة يعطيك مصفوفة results فارغة، لا خطأً. فتوقف حين تبلغ page قيمة pages.
  • الملفات المحذوفة مستبعدة.
  • ولفحص ملف واحد، استدع GET /public/v1/media/:id/status بمعرف الوسائط id، فيعيد id وpath وstatus لذلك الملف، أو 404 Media not found حين لا يكون المعرف في مكتبتك.
  • هذا الاستدعاء غير مقيد؛ فالتقييد على إنشاء المنشورات وحده (انظر حد الطلبات).