Knižnica súborov
Knižnica súborov zobrazuje zdrojové súbory, výsledky úloh a súbory aplikácií, ku ktorým má aktuálny účet prístup. Každá položka má stabilný file_id a vráti akcie, ktoré môže volajúci v danej chvíli vykonať.
Dokumenty používané ako vstup pre preklad majú tiež koncovky /api/v1/documents na zoznam, detail, aktualizáciu a odstránenie. document_id slúži na vytváranie spracovateľských úloh; file_id je určený pre oprávnenia a stiahnutia v rámci celej knižnice. Nepredpokladajte, že tieto dve ID sú zamenné.
Zoznam a podrobnosti
Section titled “Zoznam a podrobnosti”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Zoznam odpovedí:
{ "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}Ak chcete získať ďalšiu stranu, predošlite next_offset ako offset; zastavte sa, keď je has_more rovné false.
Vždy používajte capabilities každého položky na rozhodnutie, či môže byť stiahnutá, zdieľaná alebo udelená aplikácii; nepočítajte povolenia z pôvodných polí.
Stiahnuť
Section titled “Stiahnuť”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content presmerovanie (302) na krátkodobú adresu na stiahnutie; pri sledovaní presmerovania neposielajte kľúč API. Odporúča sa najskôr požiadať o download-ticket. Po uplynutí platnosti požiadajte o novú adresu; neukladajte si ju.
Oprávnenia a odkazy
Section titled “Oprávnenia a odkazy”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}Zmeny povolení a verejné odkazy sú samostatné funkcie. Pri vytváraní odkazu explicitne nastavte jeho publikum, povolenie na stiahnutie, dátum ukončenia platnosti a voliteľný počet stiahnutí; zrušte ho hneď, ako už nie je potrebný.
Zobrazenia pracovného priestoru
Section titled “Zobrazenia pracovného priestoru”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsKoncovky pracovných priestorov sú vhodné pre centrum súborov; /storage/files je vhodný pre akcie s povoleniami a sťahovaním jednotlivého súboru.