RECURSO DE API

Odontograma & Tratamento

Odontograma FDI, catálogo de serviços/procedimentos, plano de tratamento por etapas e prescrição. Os estados dos dentes são mantidos como append-only — o histórico não é apagado nem sobrescrito.

Acesso Antecipado Toda a API

Endpoints

14 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/patients/{id}/odontogram Obtém o odontograma FDI atual Todos os papéis autorizados

POST /v1/patients/{id}/odontogram Adiciona estado do dente (append-only) admin · médico

GET /v1/patients/{id}/odontogram/{tooth}/history Obtém o histórico de estado de um dente Todos os papéis autorizados

GET /v1/services Lista o catálogo de serviços/procedimentos Todos os papéis autorizados

POST /v1/services Adiciona um item de serviço admin

PUT /v1/services/{id} Atualiza o item de serviço admin

GET /v1/patients/{id}/plans Lista os planos de tratamento do paciente Todos os papéis autorizados

POST /v1/patients/{id}/plans Cria um plano de tratamento admin · médico

GET /v1/plans/{id} Obtém os detalhes do plano de tratamento Todos os papéis autorizados

POST /v1/plans/{id}/status Altera o status do plano admin · médico

POST /v1/plans/{id}/items Adiciona etapa/item ao plano admin · médico

POST /v1/plan-items/{id}/status Altera o status do item do plano admin · médico

GET /v1/patients/{id}/prescriptions Lista as prescrições Todos os papéis autorizados

POST /v1/patients/{id}/prescriptions Cria uma prescrição admin · médico

Exemplo de Uso

Adicionar estado do dente (append-only)

Requisição

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Resposta

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

Segurança neste recurso

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

Os registros de estado do dente são append-only: cada alteração é adicionada como uma nova linha, o registro antigo não pode ser modificado (integridade do histórico clínico).

A criação de plano de tratamento e prescrição é restrita apenas ao papel de admin/médico; a lógica de preço e etapa é processada no servidor.

Todos os registros são isolados à sua clínica; os cálculos de preço do plano não são recebidos do cliente, são feitos no servidor com numeric.

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 Agendamentos e calendário 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