RECURSO DE API

Agendamentos e calendário

Agendamento por médico e por cadeira, bloqueio de reserva dupla, lembrete automático e lista de espera. Os conflitos são bloqueados no nível do banco de dados.

Acesso Antecipado Toda a API

Endpoints

10 endpoint

Endpoints deste recurso. Cada endpoint é limitado aos dados da clínica à qual a chave de API está vinculada; os endpoints de gravação suportam o cabeçalho Idempotency-Key.

GET /v1/appointments Lista as consultas por intervalo de datas Todos os papéis autorizados

POST /v1/appointments Cria uma nova consulta (com verificação de conflito) admin · secretário · médico

POST /v1/appointments/{id}/status Altera o status da consulta admin · secretário · médico

POST /v1/appointments/{id}/reschedule Reagenda a consulta admin · secretário · médico

POST /v1/appointments/{id}/remind Envia lembrete de consulta admin · secretário · médico

GET /v1/units Lista as cadeiras/unidades Todos os papéis autorizados

GET /v1/doctors Lista os médicos Todos os papéis autorizados

GET /v1/waitlist Obtém a lista de espera Todos os papéis autorizados

POST /v1/waitlist Adiciona paciente à lista de espera admin · secretário · médico

DELETE /v1/waitlist/{id} Remove da lista de espera admin · secretário · médico

Exemplo de Uso

Obter as consultas por intervalo de datas

Requisição

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

Resposta

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

Segurança neste recurso

Segurança não é um recurso, é a própria arquitetura. As garantias que se aplicam a este recurso:

A reserva dupla é impossível no nível do banco de dados graças à exclusion constraint; mesmo em caso de erro da aplicação, uma consulta conflitante não pode ser gravada.

A concorrência simultânea por slot é evitada com o bloqueio distribuído do Redis; duas requisições não podem gravar no mesmo slot ao mesmo tempo.

Todos os dados de consulta são isolados à sua clínica (RLS); as alterações de status são registradas no log de auditoria.

Todo o modelo de segurança →

Formato de Erro

Os erros retornam em um envelope consistente; o código é destinado à máquina, a mensagem ao usuário. Erro interno/stack nunca é vazado.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo inválido: e-mail"
  }
}

Outros Recursos

Pacientes Odontograma & Tratamento Cobrança e Finanças Estoque Imagem Laboratório Lead & CRM Turismo de saúde Relatórios & BI Webhooks Transferência de Dados (Export API)

Deseja acesso antecipado?

Seja o primeiro a saber quando a API for lançada.

Entre em Contato