curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
مكتبة الوسائط
سرد الملفات المرفوعة
GET /media/
GET
/
media
/
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
يسرد الملفات التي رفعها الحساب نفسه، على مضيف واجهة برمجة التطبيقات للإدارة (
api.scanova.io)، مع المصادقة باستخدام مفتاح واجهة برمجة التطبيقات للإدارة الخام الخاص بك.
GET https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
التصفية حسب نوع الملف المكتشَف، مثل
png.string
التصفية حسب مؤشر الاستخدام، مثل
qr_logo.string
التصفية حسب امتداد الملف.
string
التصفية حسب نوع MIME.
boolean
تصفية الملفات التي تنتمي (أو لا تنتمي) إلى دفعة وسائط مجمّعة.
string
البحث ضمن
original_name.string
الترتيب حسب
created أو original_name أو file_size — أضف البادئة - للترتيب التنازلي. القيمة الافتراضية هي -created.string
قائمة مفصولة بفواصل بالحقول المسموح بها، لتقليص شكل الاستجابة.
integer
رقم الصفحة.
integer
عدد النتائج لكل صفحة، بحد أقصى 100.
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
لا يرفض هذا الطرف الطلبات غير المُصادَق عليها بشكل صريح — فمفتاح API المفقود أو غير الصالح يقيّد الاستعلام فقط بحيث لا يعود لأي مستخدم، لذا ستحصل على مجموعة نتائج فارغة بدلاً من
401. أرسل مفتاحك دائمًا.ذو صلة
- رفع ملف — إضافة ملف جديد.
- سرد أنواع الملفات المسموح بها — القيود التي يجب أن تستوفيها الملفات المرفوعة.
- جلب ملف — جلب ملف حسب المعرّف.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وقواعد الحصة المطبّقة على هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
معلمات الاستعلام
e.g. -created, original_name, file_size.
Comma-separated field allow-list for the response.
Max 100.
الاستجابة
200 - application/json
Paginated list of files.
هل كانت هذه الصفحة مفيدة؟