Kniha souborů
Souborová knihovna zobrazuje zdrojové soubory, výsledky úloh a soubory aplikací, ke kterým má aktuální účet přístup. Každá položka má stabilní file_id a vrátí akce, které může volající v daném okamžiku provádět.
Dokumenty používané jako vstup pro překlad také obsahují koncové body /api/v1/documents pro seznam, detail, aktualizaci a smazání. document_id slouží k vytváření zpracovatelských úloh; file_id je určen pro oprávnění a stahování v celé knihovně. Nepředpokládejte, že jsou tato dvě ID zaměnitelná.
Seznam a podrobnosti
Section titled “Seznam a podrobnosti”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Výpis odpovědi:
{ "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}Chcete-li získat další stránku, předejte next_offset jako offset; zastavte se, když je has_more rovno false.
Vždy používejte capabilities každé položky k rozhodnutí, zda může být stažena, sdílena nebo udělena aplikaci; neplyňte oprávnění z původních polí.
Stáhnout
Section titled “Stáhnout”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content přesměruje (302) na krátkodobou adresu pro stažení; při následování přesměrování neodešlete API klíč. Doporučuje se nejprve požádat o download-ticket. Po vypršení platnosti jedné adresy požádejte o novou; neukládejte ji.
Oprávnění a odkazy
Section titled “Oprávnění 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}Změny oprávnění a veřejné odkazy jsou samostatnými funkcemi. Při vytváření odkazu explicitně nastavte cílovou skupinu, oprávnění ke stažení, platnost a volitelný počet stažení; zrušte ho ihned poté, co již není potřeba.
Zobrazení pracovního prostoru
Section titled “Zobrazení pracovního prostoru”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsKoncové body pracovního prostoru vyhovují centru souborů; /storage/files vyhovuje oprávněním a akcím stahování pro jeden soubor.