Přeskočit na obsah

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á.

GET /api/v1/storage/files?offset=0&limit=50
GET /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í.

GET /api/v1/storage/files/{file_id}/content
POST /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.

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}

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.

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Koncové body pracovního prostoru vyhovují centru souborů; /storage/files vyhovuje oprávněním a akcím stahování pro jeden soubor.