Skip to main content

GET Buscar URL da Gravação

Gera uma URL assinada (temporária) para baixar um arquivo de gravação da teleconsulta.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Sem permissão específica

Não exige @CheckPermissions — qualquer usuário autenticado pode chamar.

Formato de resposta diferente das outras rotas

Ao contrário da maioria das rotas deste módulo (que embrulham o retorno em data), esta devolve a chave presignedUrl diretamente na raiz do corpo.

Endpoint​

GET https://api-dev.imagemais.com.br/api/telemedicine/recording-presigned-url

Parâmetros de Query​

NomeTipoObrigatórioDescrição
consultationIdnumber✅ID da consulta
fileIdnumber✅ID do arquivo de gravação (Files.id, com fileType = "telemedicine-recording")

Requisição​

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/telemedicine/recording-presigned-url?consultationId=123&fileId=456' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
  "presignedUrl": "https://<bucket>.r2.cloudflarestorage.com/telemedicine/<hash>/...?X-Amz-Signature=..."
}

400 Parâmetros ausentes ou inválidos​

{
  "statusCode": 400,
  "message": "Validation failed (numeric string is expected)"
}

404 Consulta não encontrada​

{
  "statusCode": 404,
  "message": "Consulta não encontrada"
}

404 Gravação não encontrada​

Retornado quando o fileId não existe, não é do tipo telemedicine-recording ou não está vinculado a essa consulta.

{
  "statusCode": 404,
  "message": "Gravação não encontrada"
}