Gerar URL de download de arquivo de um cliente

POST

/v2/files/clients/{clientId}/download

Gera uma URL assinada, de acesso temporário, para baixar um arquivo do armazenamento de documentos. Informe em fileUrl o endereço do arquivo; o arquivo é procurado, nesta ordem, no armazenamento de documentos atual, no legado, no armazenamento da análise AG-IA e, por fim, no serviço de busca de arquivos. Use a fileUrl devolvida para baixá-lo diretamente. Requer autenticação via Bearer JWT ou header x-api-key. O cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado), cliente de outra empresa devolve 401 (Acesso negado) e usuário inativo devolve 404 (Usuário não encontrado). Usuário sem perfil de permissão recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

URL assinada para download do arquivo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠403Acesso negado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/files/clients//download' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "fileUrl": "clients/9d2e5a10-3b7c-4f48-a1d6-7c0e2b8f4d33/documentos/contrato.pdf",
    "fileName": "contrato.pdf"
}'

Response Example

200 - Sucesso

{
    "fileUrl": "https://storage.googleapis.com/bucket/contrato.pdf?X-Goog-Signature=abc"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Gerar URL de upload de arquivo de um cliente

Próxima página

Visualizar relatório-resumo de um cliente