Skip to main content

POST Criar Sala

Cria a sala de telemedicina (LiveKit) para uma consulta. Chamada tipicamente pelo médico ao iniciar o atendimento.

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.

Idempotente

Se a sala já existe no LiveKit para essa consulta, a rota apenas retorna a sala existente em vez de tentar criar de novo.

Endpoint​

POST https://api-dev.imagemais.com.br/api/telemedicine/room

Corpo da Requisição​

CampoTipoObrigatórioDescrição
consultationIdnumber (inteiro positivo)✅ID da consulta
Parâmetros fixos da sala

maxParticipants: 2 (só médico + paciente) e departureTimeout: 180s (a sala é fechada pelo LiveKit 3 minutos depois que o último participante sai).

Requisição​

curl -X 'POST' \
  'https://api-dev.imagemais.com.br/api/telemedicine/room' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -d '{
  "consultationId": 123
}'

Respostas​

201 Sucesso​

Objeto Room do LiveKit completo, embrulhado em data.

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

400 Validação​

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

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