سرد الوسائط
GET /public/v1/mediaيعيد الصور والفيديوهات الموجودة في مكتبة الوسائط، لتستخدم أحدها في منشور بدل رفعه من جديد.
ويحمل كل ملف id وpath اللذين يحتاجهما إنشاء منشور، وهما الزوج
نفسه الذي يعيده رفع ملف
والرفع من عنوان.
إن كنت تفعل ذلك من التطبيق، فراجع مكتبة الوسائط. وهذه العملية
متاحة أيضًا بالأداة mediaListTool في خادم MCP من شارك، ولا
يقابلها أمر في أداة CLI.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
page |
لا | رقم الصفحة، يبدأ من 1. والقيمة الافتراضية 1. ويجب أن يكون 1 أو أكبر. |
search |
لا | جزء من الاسم الأصلي للملف. ولا فرق بين الأحرف الكبيرة والصغيرة. |
وتبدأ page هنا من 1، بخلاف سرد الإشعارات التي تبدأ من صفر،
لذا يرفض page=0.
الصفحة الأولى:
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/mediaالصفحة الثانية من الملفات التي يحتوي اسمها الأصلي على logo:
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/media?page=2&search=logo"الاستجابة
Section titled “الاستجابة”{ "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" } ]الأخطاء
Section titled “الأخطاء”| الاستجابة | المعنى |
|---|---|
400 تحقق من الحقول |
قيمة page أقل من 1، أو ليست رقمًا. |
ملاحظات
Section titled “ملاحظات”- 32 ملفًا في كل صفحة، الأحدث أولًا. وحجم الصفحة ثابت؛ فلا يوجد معامل
limit. - البحث لا يجد أبدًا ملفًا مرفوعًا عبر API. فـ
searchينظر فيoriginalNameوحده، لا فيnameالمخزن، وتلك الملفات لا يحفظ لها اسم أصلي. ولإيجاد أحدها مجددًا، احتفظ بـidالذي أعاده رفعه، أو تصفح الصفحات دونsearch. - تجاوز آخر صفحة يعطيك مصفوفة
resultsفارغة، لا خطأً. فتوقف حين تبلغpageقيمةpages. - الملفات المحذوفة مستبعدة.
- ولفحص ملف واحد، استدع
GET /public/v1/media/:id/statusبمعرف الوسائطid، فيعيدidوpathوstatusلذلك الملف، أو404Media not foundحين لا يكون المعرف في مكتبتك. - هذا الاستدعاء غير مقيد؛ فالتقييد على إنشاء المنشورات وحده (انظر حد الطلبات).