Gerar URL de download de arquivo da análise AG-IA

POST

/v2/files/clients/{clientId}/ag-ia-download

Gera uma URL assinada, de acesso temporário, para baixar um arquivo do armazenamento usado pela análise AG-IA. Informe em fileUrl o endereço do arquivo no armazenamento e use a signedUrl devolvida para baixá-lo diretamente. O usuário precisa ter perfil de permissão, e o cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado) e cliente de outra empresa devolve 401 (Acesso negado). Requer autenticação via Bearer JWT ou header x-api-key.

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

🟠422Campos inválidos

🟠403Acesso negado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/files/clients//ag-ia-download' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "fileUrl": "https://storage.example.com/ag-ia/documents/arquivo.pdf"
}'

Response Example

200 - Sucesso

{
    "signedUrl": "https://storage.example.com/ag-ia/download/signed?token=abc"
}

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

Página anterior

Gerar URL de upload de arquivo para análise AG-IA

Próxima página

Gerar URL de upload de arquivo de um cliente