انتقل إلى المحتوى الرئيسي

upload

رفع ملف إلى تخزين سحابي oneentry.

Description

تقوم هذه الطريقة برفع ملف إلى تخزين سحابي للملفات. قم بتمرير القيمة التي تم الحصول عليها من نوع الإدخال "ملف". تعيد Promise التي تحل إلى كائن IUploadingReturn[].

البيانات هي كائن ملف (أو مصفوفة)، لمعرفة المزيد - كائن الملف

FileUploading.upload(

file*, fileQuery, fileQuery.type*, fileQuery.entity*, fileQuery.id*, fileQuery.width, fileQuery.height, fileQuery.compress

);

Parameters schema

Schema

file(required): File | Blob
الملف المراد رفعه
مثال: new File(["content"], "file.png", {"type": "image/png"})

fileQuery: IUploadingQuery
مجموعة اختيارية من معلمات الاستعلام
مثال:

{
"type": "page",
"entity": "editor",
"id": 3787,
"width": 0,
"height": 0,
"compress": true,
"template": 1
}

fileQuery.type(required): string
النوع، يحدد اسم المجلد في التخزين.
مثال: "page"

fileQuery.entity(required): string
اسم الكيان الذي يتم رفع الملف منه، يحدد اسم المجلد في التخزين.
مثال: "editor"

fileQuery.id(required): number
معرف الكائن الذي يتم رفع الملف منه، يحدد اسم المجلد في التخزين.
مثال: 3787

fileQuery.width: number
معلمة العرض.
مثال: 0

fileQuery.height: number
معلمة الارتفاع.
مثال: 0

fileQuery.compress: boolean
علامة تحسين (ضغط) للصور.
مثال: true

Examples

Minimal example


const fileQuery = {
"type": "page",
"entity": "editor",
"id": 3787,
"width": 0,
"height": 0,
"compress": true
};

const response = await FileUploading.upload(file, fileQuery);

Example response

[
{
"filename": "files/project/page/3492/editor/7b949671-f7ed-4caa-b3c9-44b12cf0e7b4.md",
"downloadLink": "https://your-project.oneentry.cloud/cloud-static/files/project/page/3492/editor/7b949671-f7ed-4caa-b3c9-44b12cf0e7b4.md",
"size": 4463
}
]

Response schema

Schema: IUploadingReturn[]

filename: string
اسم الملف مع المسار النسبي.
مثال: "uploads/file.png"

downloadLink: string
رابط تحميل الملف.
مثال: "https://example.com/uploads/file.png"

size: number
حجم الملف بالبايت.
مثال: 1024