Obter URLs de custódia

Serviço para obter URLs pré-assinadas para o upload e download de um documento.

A URL de upload é válida por 5 minutos, enquanto a URL de download é válida por 5 anos.

Endpoint

GET /services/custody/upload

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
x-api-key	string	Sim	API Key de autorização de acesso.

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
uploadUrl	string	URL pré-assinada para carregar o documento. Válida por 5 minutos.
downloadUrl	string	URL pré-assinada para baixar o documento. Válida por 5 anos. Se ele for perdido, não será possível recuperar o arquivo.

Exemplo de resposta

{
  "uploadUrl": "https://storage.example.com/upload?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "downloadUrl": "https://api.identity-platform.io/custody/download?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

400 Solicitação inválida

{
  "status": 400,
  "title": "Solicitação inválida",
  "detail": "Requisição inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}

401 Não autorizado

{
  "message": "Não autorizado"
}

403 Acesso negado

{
  "Message": "O usuário não está autorizado a acessar este recurso com uma negação explícita"
}

502 Gateway inválido

{
  "status": 502,
  "title": "Gateway inválido",
  "detail": "O servidor recebeu uma resposta inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}

504 Gateway Timeout

{
  "message": "A solicitação do Endpoint excedeu o tempo limite"
}