Tovább a tartalomhoz

Fájlkönyvtár

A fájltár a jelenlegi fiók által elérhető forráskód-fájlokat, feladat eredményeit és alkalmazásfájlokat jeleníti meg. Minden elem rendelkezik egy stabil file_id azonosítóval, és visszaadja azokat a műveleteket, amelyeket a hívó jelenleg elvégezhet.

A fordítási bemenetként használt dokumentumok is rendelkeznek /api/v1/documents listázó, részletező, frissítő és törölő végpontokkal. A document_id a feldolgozási feladatok létrehozására szolgál; a file_id pedig a könyvtár-szintű engedélyekre és letöltésekre vonatkozik. Ne tételezzük fel, hogy a két azonosító felcserélhető.

GET /api/v1/storage/files?offset=0&limit=50
GET /api/v1/storage/files/{file_id}

Lista válasz:

{
"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
}

A következő oldal lekéréséhez adjon át next_offset értékét a offset paraméternek; álljon meg, amikor a has_more értéke false.

Mindig az adott elem capabilities értékeit használja annak eldöntéséhez, hogy letölthető-e, megosztható-e vagy hozzáférhetővé tehető-e egy alkalmazás számára; ne következtessen a jogosultságokra az eredeti mezők alapján.

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

A /content átirányítás (302) egy rövid életű letöltési címre vezet; az átirányítást követve ne küldje el az API-kulcsot. Javasolt először egy download-ticket lekérdezése. Egy cím lejárta után kérjen újat; ne tárolja azt.

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}

Az engedélyek módosítása és a nyilvános linkek különálló funkciók. Amikor létrehoz egy linket, állítsa be ennek célközönségét, letöltési jogosultságát, lejárati idejét és esetleges letöltési korlátját; vonja vissza azt, amint már nem szükséges.

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

A munkaterület végpontjai egy fájlközponthoz illenek; a /storage/files egyetlen fájlra vonatkozó engedélyezési és letöltési műveleteket támogat.