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

Esta rota requer o header Authorization: Bearer {accessToken}

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

Nome	Tipo	Obrigatório	Descrição
consultationId	number (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

200 Sucesso

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