Pular para o conteúdo

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.

GET /api/v1/storage/files?offset=0&limit=50
GET /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}/content
POST /api/v1/storage/files/{file_id}/download-ticket

O 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.

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}

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.

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

Os 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.