Gerar URL assinada de download de arquivo de cessão

GET

/cession/generate-download-signed-url

Gera no serviço de cessões uma URL assinada para baixar o arquivo identificado por key_id e a devolve em file_url. A URL é produzida pelo serviço de cessões e repassada como recebida. Quando o serviço de cessões recusa ou não atende a chamada, a rota devolve o mesmo status HTTP devolvido por ele (por exemplo 400, 401, 403 ou 404), ou 500 se não houver resposta, com uma mensagem de falha na comunicação seguida, depois de "Detalhes:", do detalhe da falha entre aspas. 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 Consulta

Parâmetros Header

Respostas

🟢200

application/json

URL de download gerada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Falha no serviço de cessões (requisição recusada)

🟠404Falha no serviço de cessões (não encontrado)

🔴500Falha no serviço de cessões ou erro interno

Request Example

Shell

JavaScript

Java

Swift

curl --location '/cession/generate-download-signed-url?key_id=' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "file_url": "https://arquivos.example.com/cessoes/lote-0001.zip?assinatura=abc123&expira=900"
}

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

Página anterior

Solicitar consulta de Score AgRisk de clientes

Próxima página

Gerar URL assinada de upload de arquivo de cessão