फाइल लायब्ररी
फाइल लायब्ररी स्त्रोत फाइल्स, जॉब निकाल आणि अॅप फाइल्स दर्शवते ज्या सध्याचे खाते प्रवेश करू शकते. प्रत्येक आयटमला स्थिर 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}पुढील पृष्ठ मिळवण्यासाठी, offset म्हणून next_offset पास करा; has_more false असताना थांबा.
प्रत्येक आयटमची capabilities वापरून निर्णय घ्या की ते डाउनलोड केले, सामायिक केले किंवा एखाद्या ॲपला दिले जाऊ शकते; मूळ क्षेत्रांवरून परवानग्या अनुमानित करू नका.
डाउनलोड करा
Section titled “डाउनलोड करा”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 एका एकल फाइलवरील परवानगी आणि डाउनलोड क्रियांसाठी योग्य आहे.