Gerar URL assinada de upload de arquivo de cessão

GET

/cession/generate-upload-signed-url

Gera no serviço de cessões uma URL assinada para enviar um arquivo de cessão e devolve a URL em upload_url, com a referência do arquivo no serviço em file_reference. A rota não recebe parâmetros. Envie o arquivo para upload_url e use a referência ao registrar a cessão. Quando o serviço de cessões recusa ou não atende a chamada, a rota devolve o mesmo status HTTP devolvido por ele, 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 Header

Respostas

🟢200

application/json

URL de upload gerada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

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

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Sucesso

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

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

Página anterior

Gerar URL assinada de download de arquivo de cessão

Próxima página

Calcular custo de registro de CPR Ag