Skip to main content

GET Buscar Sala

Retorna os dados da sala LiveKit já criada para uma consulta (não cria a sala — use Criar Sala antes).

Autenticação necessária

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

Rota quebrada na versão atual

Testado em 29/09/2026: qualquer consultationId retorna 400, porque o parâmetro de rota chega como texto e o DTO (ConsultationDto) exige número sem conversão. Registrado nas pendências de código. Resposta atual:

{"message": ["ID da consulta deve ser um número positivo", "ID da consulta deve ser um número"], "error": "Bad Request", "statusCode": 400}

Sem permissão específica

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


Endpoint​

GET https://api-dev.imagemais.com.br/api/telemedicine/room/{consultationId}

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
consultationIdnumber (inteiro positivo)✅ID da consulta
Consulta precisa estar aberta e ser online

A consulta só é encontrada se pertencer à conta do token, estiver com status OPENED e tipo ONLINE. Fora disso, 404.


Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/telemedicine/room/123' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

400 Comportamento atual (bug)​

Qualquer chamada retorna este erro — ver aviso no topo da página.

{
"message": [
"ID da consulta deve ser um número positivo",
"ID da consulta deve ser um número"
],
"error": "Bad Request",
"statusCode": 400
}

200 Sucesso (comportamento pretendido)​

Objeto Room do LiveKit (parcial), embrulhado em data.

{
"data": {
"sid": "RM_xxxxxxxxxxxx",
"name": "telemedicine-123-1753000000000",
"emptyTimeout": 0,
"departureTimeout": 180,
"maxParticipants": 2,
"creationTime": "1753000000",
"turnPassword": "...",
"enabledCodecs": [],
"metadata": "{\"status\":\"OPENED\"}",
"numParticipants": 1,
"numPublishers": 1,
"activeRecording": false
}
}

404 Consulta não encontrada​

Retornado quando a consulta não existe, não pertence à conta, não está OPENED ou não é ONLINE.

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

404 Sala de telemedicina não encontrada​

Retornado quando a consulta existe, mas a sala ainda não foi criada (ver Criar Sala).

{
"statusCode": 404,
"message": "Sala de telemedicina não encontrada"
}