GET Verificar se Agendamento é Encaixe

Verifica se um agendamento seria classificado como encaixe.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

---

Endpoint

GET https://api-dev.imagemais.com.br/api/appointments/check-encaixe

---

Parâmetros de Query

Nome	Tipo	Obrigatório	Descrição
doctorId	number	✅	ID do médico
date	string	✅	Data do agendamento no formato YYYY-MM-DD
startTime	string	✅	Horário de início no formato HH:mm

Encoding do horário

O caractere : do startTime é codificado como %3A na URL. Exemplo: 10:31 → 10%3A31. A maioria dos clientes HTTP faz isso automaticamente.

---

Requisição

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/appointments/check-encaixe?doctorId=22&date=2026-05-16&startTime=10%3A31' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {accessToken}'

---

Respostas

200 Sucesso

{
  "isFit": true,
  "reason": "same_shift"
}

Campo	Tipo	Descrição
isFit	boolean	true se o horário é classificado como encaixe, false caso contrário
reason	string | null	Motivo da classificação. null quando isFit é false

Valores possíveis de reason

Valor	Descrição
same_shift	O horário está dentro do turno do médico mas sobrepõe um slot existente
no_free_slots	Não há slots livres disponíveis no horário informado
null	Não se aplica — retornado quando isFit é false