POST/api/uploads/download-url

Link para baixar

Um link temporário que baixa o arquivo com o nome que você escolher.

  • Exige o token de acesso — como obter
  • Limite: 240 por minuto, por IP

Headers

NomeTipoObrig.Descrição
Authorization
stringSimBearer {access_token}, com o token que o login devolve.
Content-Type
stringSimapplication/json

Corpo da requisição

NomeTipoObrig.Descrição
url
stringSimA url do arquivo, como vem na lista de arquivos.
filename
stringSimO nome com que o arquivo deve ser salvo.

Campos da resposta

NomeTipoDescrição
download_url
stringO link temporário.

Request URL

https://api-endosystem.imagemais.com.br/api/uploads/download-url
curl -X POST "https://api-endosystem.imagemais.com.br/api/uploads/download-url" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm","filename":"maria-da-silva-captura-01.dcm"}'
{
  "url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm",
  "filename": "maria-da-silva-captura-01.dcm"
  ...
{
  "url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm",
  "filename": "maria-da-silva-captura-01.dcm"
}

Respostas

{
  "download_url": "https://<conta>.r2.cloudflarestorage.com/bucket/videocolposcopia/...&X-Amz-Signature=..."
}
{
  "download_url": "https://<conta>.r2.cloudflarestorage.com/bucket/videocolposcopia/...&X-Amz-Signature=..."
}
{
  "error": "url e filename são obrigatórios"
}
{
  "error": "url e filename são obrigatórios"
}
{
  "error": "URL fora do armazenamento deste sistema"
}
{
  "error": "URL fora do armazenamento deste sistema"
}
{
  "error": "Arquivo não encontrado"
}
{
  "error": "Arquivo não encontrado"
}
{
  "error": "Muitas requisições. Tente novamente em instantes."
}
{
  "error": "Muitas requisições. Tente novamente em instantes."
}
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}