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

مكتبة الملفات

تعرض مكتبة الملفات الملفات المصدرية ونتائج المهام وملفات التطبيق التي يمكن للحساب الحالي الوصول إليها. يحتوي كل عنصر على معرّف ثابت file_id ويعيد الإجراءات التي يمكن للمستدعي تنفيذها حاليًا.

تتضمن المستندات المستخدمة كمدخل للترجمة أيضًا نقاط نهاية /api/v1/documents للقائمة والتفاصيل والتحديث والحذف. أما document_id فهو مخصص لإنشاء وظائف المعالجة؛ وfile_id مخصص للأذونات على مستوى المكتبة والتنزيلات. يُرجى عدم افتراض إمكانية تبديل هذين المعرفين ببعضهما البعض.

GET /api/v1/storage/files?offset=0&limit=50
GET /api/v1/storage/files/{file_id}

قائمة الاستجابة:

{
"items": [
{
"id": "x7m4q2k9n6c1v8pa",
"name": "report.docx",
"content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"size_bytes": 45678,
"status": "ready",
"publication_status": "draft",
"origin": {
"product_code": "omnidoc-main",
"display_name": "OmniDoc"
},
"capabilities": {
"can_view": true,
"can_download": true,
"can_update": true,
"can_delete": true,
"can_share": true
},
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-01T12:00:00Z"
}
],
"has_more": true,
"next_offset": 50
}

للحصول على الصفحة التالية، مرر next_offset كـ offset؛ توقف عندما يكون has_more هو false.

استخدم دائمًا capabilities الخاص بكل عنصر لتحديد ما إذا كان يمكن تنزيله أو مشاركته أو منحه لتطبيق؛ ولا تستنتج الأذونات من حقول المصدر.

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

يقوم /content بإعادة التوجيه (302) إلى عنوان تنزيل قصير الأمد؛ لا ترسل مفتاح API عند اتباع إعادة التوجيه. يُنصح أولاً بطلب download-ticket. اطلب عنوانًا جديدًا بعد انتهاء صلاحية العنوان السابق؛ ولا تخزنه.

GET /api/v1/storage/files/{file_id}/permissions
POST /api/v1/storage/files/{file_id}/permissions
DELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/links
POST /api/v1/storage/files/{file_id}/links
DELETE /api/v1/storage/files/{file_id}/links/{link_id}

تُعد تغييرات الأذونات والروابط العامة ميزات منفصلة. عند إنشاء رابط، حدد جمهوره وأذن التنزيل وتاريخ انتهاء الصلاحية وعدد مرات التنزيل (اختياري) بشكل صريح؛ وقم بإلغائه فور عدم الحاجة إليه.

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

تتناسب نقاط نهاية مساحة العمل مع مركز الملفات؛ و/storage/files يناسب إجراءات الأذونات والتنزيل على ملف واحد.