Preskočiť na obsah

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

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

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

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}

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

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

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