Salta ai contenuti

Libreria file

La libreria dei file mostra i file sorgente, i risultati dei job e i file dell’app a cui l’account corrente ha accesso. Ogni elemento dispone di un identificatore file_id stabile e restituisce le azioni che il chiamante può attualmente eseguire.

I documenti utilizzati come input per la traduzione dispongono anch’essi degli endpoint /api/v1/documents list, detail, update e delete. document_id serve per creare job di elaborazione; file_id è destinato alle autorizzazioni a livello di libreria e ai download. Non assumere che i due ID siano intercambiabili.

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

Risposta dell’elenco:

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

Per ottenere la pagina successiva, passa next_offset come offset; interrompi quando has_more è false.

Utilizzare sempre il capabilities di ciascun elemento per determinare se può essere scaricato, condiviso o concesso a un’app; non dedurre le autorizzazioni dai campi di origine.

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

/content reindirizza (302) a un indirizzo di download temporaneo; non inviare la chiave API seguendo il reindirizzamento. Si consiglia di richiedere prima un download-ticket. Richiedi un nuovo indirizzo dopo la scadenza di quello precedente; non memorizzarlo.

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}

Le modifiche alle autorizzazioni e i link pubblici sono funzionalità distinte. Quando crei un link, definisci esplicitamente il pubblico, l’autorizzazione al download, la data di scadenza e, facoltativamente, il numero massimo di download; revocalo non appena non è più necessario.

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

Gli endpoint dell’area di lavoro sono adatti a un centro file; /storage/files è indicato per le azioni di autorizzazione e download su un singolo file.