GET Buscar Sala
Retorna os dados da sala LiveKit já criada para uma consulta (não cria a sala — use Criar Sala antes).
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
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}
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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
consultationId | number (inteiro positivo) | ✅ | ID da consulta |
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"
}