مكتبة الملفات
تعرض مكتبة الملفات الملفات المصدرية ونتائج المهام وملفات التطبيق التي يمكن للحساب الحالي الوصول إليها. يحتوي كل عنصر على معرّف ثابت file_id ويعيد الإجراءات التي يمكن للمستدعي تنفيذها حاليًا.
تتضمن المستندات المستخدمة كمدخل للترجمة أيضًا نقاط نهاية /api/v1/documents للقائمة والتفاصيل والتحديث والحذف. أما document_id فهو مخصص لإنشاء وظائف المعالجة؛ وfile_id مخصص للأذونات على مستوى المكتبة والتنزيلات. يُرجى عدم افتراض إمكانية تبديل هذين المعرفين ببعضهما البعض.
قائمة وتفاصيل
Section titled “قائمة وتفاصيل”GET /api/v1/storage/files?offset=0&limit=50GET /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}/contentPOST /api/v1/storage/files/{file_id}/download-ticketيقوم /content بإعادة التوجيه (302) إلى عنوان تنزيل قصير الأمد؛ لا ترسل مفتاح API عند اتباع إعادة التوجيه. يُنصح أولاً بطلب download-ticket. اطلب عنوانًا جديدًا بعد انتهاء صلاحية العنوان السابق؛ ولا تخزنه.
الأذونات والروابط
Section titled “الأذونات والروابط”GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}تُعد تغييرات الأذونات والروابط العامة ميزات منفصلة. عند إنشاء رابط، حدد جمهوره وأذن التنزيل وتاريخ انتهاء الصلاحية وعدد مرات التنزيل (اختياري) بشكل صريح؛ وقم بإلغائه فور عدم الحاجة إليه.
طرق عرض مساحة العمل
Section titled “طرق عرض مساحة العمل”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsتتناسب نقاط نهاية مساحة العمل مع مركز الملفات؛ و/storage/files يناسب إجراءات الأذونات والتنزيل على ملف واحد.