跳转到内容

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.

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

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

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}

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.

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

Krajevi radne površine odgovaraju centru za datoteke; /storage/files odgovara akcijama dopuštenja i preuzimanja na pojedinačnoj datoteci.