跳转到内容

फाइल लायब्ररी

फाइल लायब्ररी स्त्रोत फाइल्स, जॉब निकाल आणि अॅप फाइल्स दर्शवते ज्या सध्याचे खाते प्रवेश करू शकते. प्रत्येक आयटमला स्थिर 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
}

पुढील पृष्ठ मिळवण्यासाठी, offset म्हणून next_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}

परवाना बदल आणि सार्वजनिक दुवे हे वेगळे क्षमता आहेत. जेव्हा आपण एखादा दुवा तयार करता, तेव्हा त्याचे प्रेक्षक, डाउनलोड परवाना, मुदत समाप्ती आणि पर्यायी डाउनलोड मोजणी स्पष्टपणे सेट करा; जेव्हा त्याची आवश्यकता राहणार नाही तेव्हा तो त्वरित रद्द करा.

वर्कस्पेस दृश्ये

Section titled “वर्कस्पेस दृश्ये”
GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

कार्यक्षेत्र शेवटचे बिंदू फाइल केंद्रासाठी योग्य आहेत; /storage/files एका एकल फाइलवरील परवानगी आणि डाउनलोड क्रियांसाठी योग्य आहे.