Biblioteka datoteka
Knjižnica datoteka prikazuje izvorne datoteke, rezultate zadataka i datoteke aplikacije do kojih trenutni račun može pristupiti. Svaki element ima stabilnu file_id i vraća akcije koje pozivatelj trenutno može izvršiti.
Dokumenti korišteni kao ulaz za prijevod također imaju točke endpunkata /api/v1/documents za popis, detalje, ažuriranje i brisanje. document_id služi za kreiranje zadataka obrade; file_id je za dozvole na razini knjižnice i preuzimanja. Ne pretpostavljajte da su ta dva ID-a zamjenjiva.
Popis i detalji
Section titled “Popis i detalji”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Popis odgovora:
{ "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}Za dobivanje sljedeće stranice, prođite kroz next_offset kao offset; zaustavite se kada je has_more false.
Uvijek koristite capabilities za svaku stavku kako biste odlučili može li se preuzeti, dijeliti ili dodijeliti aplikaciji; ne zaključujte dozvole na temelju polja porijekla.
Preuzimanje
Section titled “Preuzimanje”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content preusmjerava (302) na privremenu adresu za preuzimanje; ne šaljite API ključ prilikom praćenja preusmjerenja. Preporuča se prvo zatražiti download-ticket. Zatražite novu adresu nakon što istekne; nemojte je pohranjivati.
Dozvole i poveznice
Section titled “Dozvole i poveznice”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}Promjene dozvola i javne poveznice su odvojene mogućnosti. Kada kreirate poveznicu, eksplicitno postavite ciljanu publiku, dozvolu za preuzimanje, vrijeme isteka i opcionalni broj preuzimanja; opozovite je čim više nije potrebna.
Pogledi radne površine
Section titled “Pogledi radne površine”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsKrajevi radne površine odgovaraju centru za datoteke; /storage/files odgovara akcijama dopuštenja i preuzimanja na pojedinačnoj datoteci.