curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"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"
}
مكتبة الوسائط
رفع ملف
POST /media/
POST
/
media
/
curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"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)، مع المصادقة باستخدام مفتاح واجهة برمجة التطبيقات للإدارة الخام الخاص بك.
POST https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Content-Type: multipart/form-data
file
مطلوب
الملف المراد رفعه. يلزم توفير
file أو upload.file
اسم بديل لـ
file — قدّم أحدهما.string
فئات مفصولة بفواصل يُقيَّد بها التحقق (
image وvideo وaudio وpdf وdoc وscript). راجع سرد أنواع الملفات المسموح بها لمعرفة معايير القبول لكل فئة.string
كيفية استخدام هذا الملف:
avatar أو qr_logo أو qr_content أو poster أو qr_image أو profile_pic أو banner أو smart أو thumbnail، أو unknown (الافتراضي).string
تسمية فئة بنص حر، مثل رمز فئة رمز QR أو
"Custom Design".integer
معرّف دفعة وسائط مجمّعة، من إنشاء دفعة وسائط مجمّعة، لربط هذا الرفع بها.
curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"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"
}
التحقق
- يجب أن يكون الامتداد ونوع MIME كلاهما ضمن القائمة المسموح بها للفئة
file_typeالمكتشفة — يُرفض أي تعارض (مثل امتداد.pngلملف هو في الواقع PDF). - يُتحقق من الحجم مقابل حد الفئة — باستثناء ملفات
pdf/doc، حيث تحل حصة الخطةDOCUMENT_FILE_SIZEالخاصة بالحساب (بالميغابايت) محل الحد الثابت. - يُحلَّل JavaScript (
.js) المرفوع للتأكد من أنه صياغة JS صحيحة قبل التحقق من الحجم. - تُفحص ملفات SVG بحثًا عن نصوص برمجية مضمّنة وتُرفض في حال العثور عليها.
- تُرفض الملفات بدون امتداد تمامًا.
400 عند أي من أخطاء التحقق أعلاه، مع رسالة تحدد المشكلة.
ذو صلة
- سرد الملفات المرفوعة — رؤية ما تم رفعه بالفعل.
- سرد أنواع الملفات المسموح بها — التحقق من جانب العميل قبل الرفع.
- حذف ملف — إزالة ملف.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وقواعد الحصة المطبّقة على هذا الطرف.
التفويضات
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.
الاستجابة
File uploaded.
هل كانت هذه الصفحة مفيدة؟