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

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

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"
}