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.
Elenco e dettagli
Sezione intitolata “Elenco e dettagli”GET /api/v1/storage/files?offset=0&limit=50GET /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.
Scarica
Sezione intitolata “Scarica”GET /api/v1/storage/files/{file_id}/contentPOST /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.
Autorizzazioni e collegamenti
Sezione intitolata “Autorizzazioni e collegamenti”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}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.
Visualizzazioni dell’area di lavoro
Sezione intitolata “Visualizzazioni dell’area di lavoro”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsGli 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.