Fájlkönyvtár
A fájltár a jelenlegi fiók által elérhető forráskód-fájlokat, feladat eredményeit és alkalmazásfájlokat jeleníti meg. Minden elem rendelkezik egy stabil file_id azonosítóval, és visszaadja azokat a műveleteket, amelyeket a hívó jelenleg elvégezhet.
A fordítási bemenetként használt dokumentumok is rendelkeznek /api/v1/documents listázó, részletező, frissítő és törölő végpontokkal. A document_id a feldolgozási feladatok létrehozására szolgál; a file_id pedig a könyvtár-szintű engedélyekre és letöltésekre vonatkozik. Ne tételezzük fel, hogy a két azonosító felcserélhető.
Felsorolás és részletezés
Szekció neve “Felsorolás és részletezés”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Lista válasz:
{ "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}A következő oldal lekéréséhez adjon át next_offset értékét a offset paraméternek; álljon meg, amikor a has_more értéke false.
Mindig az adott elem capabilities értékeit használja annak eldöntéséhez, hogy letölthető-e, megosztható-e vagy hozzáférhetővé tehető-e egy alkalmazás számára; ne következtessen a jogosultságokra az eredeti mezők alapján.
Letöltés
Szekció neve “Letöltés”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticketA /content átirányítás (302) egy rövid életű letöltési címre vezet; az átirányítást követve ne küldje el az API-kulcsot. Javasolt először egy download-ticket lekérdezése. Egy cím lejárta után kérjen újat; ne tárolja azt.
Engedélyek és linkek
Szekció neve “Engedélyek és linkek”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}Az engedélyek módosítása és a nyilvános linkek különálló funkciók. Amikor létrehoz egy linket, állítsa be ennek célközönségét, letöltési jogosultságát, lejárati idejét és esetleges letöltési korlátját; vonja vissza azt, amint már nem szükséges.
Munkaterület nézetek
Szekció neve “Munkaterület nézetek”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsA munkaterület végpontjai egy fájlközponthoz illenek; a /storage/files egyetlen fájlra vonatkozó engedélyezési és letöltési műveleteket támogat.