| name | dontus-api-endpoints |
| description | Mapeamento completo dos endpoints da API do Dontus (sistema.dontus.com.br) — endpoints oficiais, alternativos descobertos, e estratégia para obter horários de agendamento que a API principal não retorna. |
| category | operacao |
Dontus API — Endpoints e Estratégias
Contexto
O Dontus (SaaS odontológico ASP.NET MVC em sistema.dontus.com.br) expõe APIs JSON via X-Requested-With: XMLHttpRequest após login com CSRF. O DontusClient em /var/www/dontus_app/dontus/client.py implementa 5 endpoints principais, mas há outros descobertos via inspeção do JavaScript nas páginas HTML.
Credenciais: config.yaml em /var/www/dontus_app/config.yaml:
url_base: https://sistema.dontus.com.brid_dontus: {{DONTUS_CLINICA_ID}}usuario: {{COMMANDER}}id_clinica: 1
Problema Crítico: Horários Ausentes
A API /Agendamento/GetAgendamentos (usada pelo get_agenda_dia()) retorna ScheduledTime: null e DataAtual: "0001-01-01T00:00:00" para TODOS os agendamentos. Os horários NÃO estão nesse endpoint.
Solução: /Paciente/GetAgendamentosPaciente?id={ID_PACIENTE}
Endpoint GOLD — retorna JSON com todos os agendamentos do paciente, INCLUINDO horários:
GET /Paciente/GetAgendamentosPaciente?id=346
Headers: X-Requested-With: XMLHttpRequest
Campos relevantes no retorno:
| Campo | Exemplo | Descrição |
|---|
DataAgendamento | "2026-05-21T18:00:00" | Data e hora ISO 8601 |
Horario | "18:00" | Horário separado (string) |
Funcionario.Nome | "Thaísa Stradiotti" | Profissional vinculado |
DescricaoStatus | "AGENDADO", "ATENDIDO", "Confirmado", "CANCELADO" | Status do agendamento |
Tempo | 60 | Duração em minutos |
Observacao | "Segunda sessão de raspagem..." | Notas clínicas |
IDEspecialidade | 11 | ID da especialidade |
Especialidade.Descricao | "PRÓTESE" | Nome da especialidade |
CodigoConfirmacao | UUID | Código de confirmação |
Color | "#3a87ad" | Cor na agenda |
Estratégia para obter agenda com horários:
- Chamar
GetAgendamentos para obter lista do dia (com IDPaciente)
- Para cada agendamento, chamar
GetAgendamentosPaciente?id={IDPaciente}
- Extrair horário do agendamento cujo
DataAgendamento corresponde ao dia
Nota: GetAgendamentosPaciente também funciona via POST.
Endpoints Mapeados
Endpoints Oficiais (já no DontusClient)
| Método | Endpoint | Params |
|---|
get_pacientes() | /DiaPaciente/GetPacientes | idClinica |
get_atendimentos(inicio, fim) | /DiaPaciente/GetAtendimentos | dataAbertura, dataFechamento, idClinica |
get_pacientes_ausentes(dias) | /DiaPaciente/GetPacientesAusentes | idClinica, dias |
get_agenda_dia(dia) | /Agendamento/GetAgendamentos | data (YYYY-MM-DD) |
get_orcamentos(status) | /Orcamento/GetOrcamentos | idClinica, status |
Endpoints Implementados no Client (TASK-DONTUS-003 + CRUD)
| Endpoint | Método no client | Detalhes |
|---|
GET /Paciente/GetAgendamentosPaciente?id={ID} | get_agendamentos_paciente(id) | JSON puro (Content-Type: application/json), array com DataAgendamento (ISO 8601), Horario (HH:MM), Funcionario.Nome, DescricaoStatus, Tempo. Cacheado por id. |
GET /Orto/GetPacientesOrto | get_pacientes_orto() | JSON DataTables, 37 pacientes. |
POST /Paciente/Save | create_paciente(nome, cel) | Payload mínimo: {ID:0, Nome, Cel, IDClinica, Status:true}. Retorna {ID: int}. Cadastro rápido sem AbrirLead(). |
POST /Agendamento/Save | create_agendamento(...) | Payload: {agendamento: {ID:0, IDPaciente, IDFuncionario, IDClinica, IDStatus, Tempo, DataAgendamento, Horario, Observacao, ...}}. Ver estrutura completa no código. |
POST /Agendamento/Delete | delete_agendamento(id) | Payload: {id}. Remove agendamento. |
Pitfall — Status: O Dontus só envia confirmação automática (SMS/WhatsApp) quando status = 1 (AGENDADO). Status 4 (Confirmado) bloqueia o envio. Use sempre 1 como padrão para novos agendamentos.
Endpoints Descobertos (NÃO implementados no client)
| Endpoint | Descrição | Retorno |
|---|
/Paciente/GetAtendimentosPaciente?id={ID} | Histórico de atendimentos | JSON (confirmado 200, ~10KB) |
/Paciente/GetTratamentosPaciente | Tratamentos vinculados ao paciente | JSON (presente no JS da página) |
/Paciente/GetPagamentosPaciente | Financeiro do paciente | JSON (presente no JS da página) |
/Relatorios/RelatorioAgendamento | Relatório HTML de agenda | HTML (200, ~200KB) |
/Indicativo/IndicativoAgendamento | Indicadores de agendamento | HTML (200, ~177KB) |
/CRCInteracao/GetHistoricoInteracoes | Histórico CRC/WhatsApp | JSON (presente no JS da página) |
/Funcionario/GetFuncionarios | Lista de profissionais | Retorna {funcionarios: []} vazio — usar nomes embedded nos agendamentos |
Profissionais (mapeados via agendamentos)
| ID | Nome |
|---|
| 1 | {{COMMANDER}} Faé |
| 2 | Thaísa Stradiotti |
Confirmado em 21/05/2026 via cruzamento de GetAgendamentos com GetAgendamentosPaciente. Não há outros profissionais com agendamentos ativos. IDs extraídos do campo IDFuncionario nos JSONs de agendamento.
| /Orto/Edit/{id} | Página de edição ortodôntica | HTML |
Status de Agendamento
| ID | DescricaoStatus |
|---|
| 1 | AGENDADO |
| 3 | CANCELADO |
| 4 | Confirmado |
| 6 | ATENDIDO |
Metodologia de Exploração
Como descobrir novos endpoints
- Usar o
DontusClient existente para fazer login e obter sessão autenticada
- Acessar páginas HTML (ex:
/Paciente/Edit/346, /Orto, /Agendamento) e extrair chamadas de API do JavaScript:
import re
apis = re.findall(r'(?:url|action|href)\s*[:=]\s*[\"\\']([^\"\\']*(?:Get|List|Load|Search|Agenda)[^\"\\']*)[\"\\']', html, re.IGNORECASE)
- Testar endpoints com
X-Requested-With: XMLHttpRequest (obrigatório para APIs JSON)
- Tentar variações de parâmetros (
id, ID, idPaciente, pacienteId, IDPaciente)
Pitfalls
- Navegador: Servidor OVH é headless (sem Chrome/Chromium). NÃO usar browser tools — usar HTTP direto via
httpx + sessão do DontusClient.
- Timeout: O Dontus é lento. Usar
timeout 25-30 para comandos. Evitar múltiplas requisições em sequência longa.
- Sessão: O atributo é
_session (privado), não session.
- DataTables: Alguns endpoints (ex:
/Orto/GetPacientesOrto) usam formato DataTables ({draw, iTotalRecords, iTotalDisplayRecords, data: [...]}), não array puro.
/Account/Login: Retorna 404. URL correta é /Login.- Funcionários: O endpoint
GetFuncionarios retorna vazio. Nomes de profissionais vêm embedded nos objetos de agendamento (Funcionario.Nome).
Dependências para exploração
cd /var/www/dontus_app && uv run python3 -c "..."
O uv run garante que todas as dependências (httpx, beautifulsoup4, xlrd) estejam disponíveis.
Mapa de Módulos do Dontus (PRD v2 — 25/05/2026)
Crawling exaustivo revelou 18 módulos, 132 páginas, ~25MB de HTML. A lista de 7 endpoints descobertos é apenas a ponta do iceberg. O sistema completo:
1. 📊 DIA — Dashboard / Home 1 pag 229 KB
2. 📅 AGENDAMENTO — Agenda 1 pag 374 KB
3. 👤 PACIENTE — Pacientes 2 pag 303 KB
4. 🏥 ATENDIMENTO — Fluxo de Atendimento 4 pag 831 KB
5. 💰 FINANCEIRO — 17 submódulos 19 pag 3,8 MB
6. 🧾 ORÇAMENTO — Orçamentos 2 pag 456 KB
7. 🐂 ORTO — Ortodontia 1 pag 154 KB
8. 💬 CRC — Comunicação 3 pag 520 KB
9. 📈 GRÁFICOS — 10 dashboards 10 pag 1,7 MB
10. 📊 INDICATIVOS — 15 dashboards 15 pag 2,9 MB
11. 📋 RELATÓRIOS — 26 relatórios 26 pag 4,9 MB
12. 📢 MARKETING — Campanhas + SMS 4 pag 654 KB
13. 🛡️ SAC — Atendimento ao Consumidor 1 pag 260 KB
14. 🔐 AUDITORIA — Permissões + Auditoria 3 pag 520 KB
15. ⚙️ CONFIGURAÇÃO — Clínica + Usuários 6 pag 858 KB
16. 📦 CADASTROS — 30+ entidades 31 pag 4,3 MB
17. 📄 DOCUMENTOS — Atestados/Contratos/etc 6 pag 903 KB
18. 🔄 OUTROS — Retorno, Metas, Mensagem 8 pag 1,1 MB
Novos módulos não cobertos antes
| Módulo | Descoberto em | Páginas |
|---|
| Atendimento (Fila + Painel) | PRD v2 | 4 |
| Gráficos (10 dashboards) | PRD v2 | 10 |
| Marketing (Campanhas + SMS) | PRD v2 | 4 |
| SAC | PRD v2 | 1 |
| Auditoria + Permissões | PRD v2 | 3 |
| Documentos + Assinatura Eletrônica | PRD v2 | 6 |
| NFSe + DontusPay + Voucher | PRD v2 | 5 |
Páginas de Edição (as mais densas)
| Página | Tamanho | Conteúdo |
|---|
/Paciente/Edit/{id} | 1.6 MB | 22 formulários (dados pessoais, contato, endereço, documentos, anamnese, financeiro, odontograma, galeria, HOF, etc) |
/Orcamento/Edit/{id} | 1.3 MB | Odontograma interativo, procedimentos por dente, laboratório, parcelamento |
/Orto/Edit/{id} | 734 KB | Tratamento, mensalidades, recorrência, contas |
Observação sobre o PRD "Bíblia"
O PRD v2 documenta o sistema em nível de páginas e tabelas, mas o {{COMMANDER}} exige detalhamento campo-a-campo (cada input, botão, regra). Veja a skill prd-clone-exhaustivo para a metodologia completa de documentação exaustiva.
Recomendações para o Lirin
Adicionar ao DontusClient: get_agendamentos_paciente(id) e get_pacientes_orto() ✅ TASK-DONTUS-003Comando agenda: Cruzar GetAgendamentos + GetAgendamentosPaciente para exibir horários ✅ TASK-DONTUS-003- Endpoint composto: Criar no
dontus_app um endpoint que faz o loop internamente, reduzindo N+1 chamadas
- Cron de manhã: Agenda do dia com horários + pacientes orto com consulta no dia
