Biblioteca de arquivos
A biblioteca de arquivos exibe os arquivos de origem, os resultados dos trabalhos e os arquivos do aplicativo aos quais a conta atual tem acesso. Cada item possui um identificador file_id estável e retorna as ações que o chamador pode executar no momento.
Os documentos utilizados como entrada de tradução também possuem os endpoints /api/v1/documents list, detail, update e delete. document_id destina-se à criação de trabalhos de processamento; file_id refere-se a permissões e downloads em toda a biblioteca. Não presuma que esses dois IDs são intercambiáveis.
Listar e detalhar
Seção intitulada “Listar e detalhar”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Resposta da lista:
{ "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}Para obter a próxima página, passe next_offset como offset; pare quando has_more for false.
Sempre use o capabilities de cada item para determinar se ele pode ser baixado, compartilhado ou concedido a um aplicativo; não infera permissões a partir dos campos de origem.
GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticketO redirecionamento /content (302) aponta para um endereço de download de curta duração; não envie a chave da API ao seguir o redirecionamento. Recomenda-se solicitar um download-ticket primeiro. Solicite um novo endereço após o expirar do anterior; não o armazene.
Permissões e links
Seção intitulada “Permissões e links”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}As alterações de permissão e os links públicos são recursos independentes. Ao criar um link, defina explicitamente seu público, a permissão para download, o período de validade e, opcionalmente, o número máximo de downloads; revogue-o assim que não for mais necessário.
Visualizações do espaço de trabalho
Seção intitulada “Visualizações do espaço de trabalho”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsOs endpoints do workspace são adequados para um centro de arquivos; /storage/files é adequado para ações de permissão e download em um único arquivo.