Endpoints da API¶
Health Check¶
GET /health¶
Verificação de saúde. Não requer autenticação.
Response: {"status": "healthy"}
Autenticação (/api/auth)¶
POST /auth/login¶
Login com username e senha. Retorna JWT com 8h de validade.
POST /auth/logout¶
Logout (para fins de auditoria).
GET /auth/verify¶
Verifica se o token atual é válido.
Métricas Técnicas (/api/metrics)¶
GET /metrics/summary¶
Cards de resumo: processados, pendentes, agravos, taxa.
GET /metrics/charts/timeline¶
Dados para gráfico de timeline. Param: period (24h|7d|30d).
GET /metrics/charts/distribution¶
Distribuição de status (hoje) para gráfico de pizza.
GET /metrics/charts/ai-funnel¶
Funil da IA: processados → com agravo → validados → aprovados.
Log de Execução (/api/logs)¶
GET /logs¶
Log paginado com filtros: page, limit, filter_status, search, sort_by, sort_order.
GET /logs/export¶
Export CSV dos logs com os mesmos filtros.
Dashboard de Saúde (/api/health)¶
GET /health/dashboard/kpis¶
KPIs: total atendimentos, com agravo, confirmados, suspeitos.
GET /health/cases/list¶
Lista de casos paginada com filtros e ordenação.
GET /health/cases/{boletim_gid}/clinical-view¶
Visão clínica detalhada de um caso.
GET /health/cases/export-csv¶
Export CSV com bairro, município, UF.
GET /health/cids/ranking¶
Ranking dos CIDs mais frequentes.
GET /health/units/ranking¶
Top N unidades por volume de agravos.
GET /health/agravos/ranking¶
Ranking de agravos detectados.
GET /health/agravos/trend¶
Tendência de agravos ao longo do tempo.
GET /health/agravos/trend-versioned¶
Tendência com anotações de mudança de versão.
POST /health/reprocess (ADMIN)¶
Simulação de reclassificação retroativa (read-only).
GET /health/patient-states¶
Distribuição de estados do paciente.
GET /health/map-data¶
Dados georeferenciados para o mapa.
GET /health/estabelecimentos¶
Lista de estabelecimentos filtrados por cenário.
GET /health/config/maps-key¶
API key do Google Maps.
Detalhes do Boletim (/api/boletim)¶
GET /boletim/{id_boletim}/detalhes¶
Detalhes completos com razões de classificação.
GET /boletim/{id_log}/ai-trace¶
Rastreio das chamadas de IA (prompt, resposta, tokens).
DataLake (/api/datalake)¶
GET /datalake/summary¶
Cards de volumetria do pipeline.
GET /datalake/units¶
Lista de unidades com datas de primeiro registro.
GET /datalake/watchdog-status¶
Status do watchdog.
GET /datalake/pipeline¶
Timeline ingestão vs processamento.
Cenários (/api/cenarios)¶
GET /cenarios¶
Lista todos os cenários.
GET /cenarios/{id}¶
Detalhes de um cenário.
POST /cenarios (ADMIN)¶
Criar novo cenário.
PUT /cenarios/{id} (ADMIN)¶
Atualizar cenário.
POST /cenarios/{id}/ativar (ADMIN)¶
Ativar cenário.
POST /cenarios/{id}/congelar (ADMIN)¶
Congelar cenário.
POST /cenarios/{id}/arquivar (ADMIN)¶
Arquivar cenário.
GET /cenarios/{id}/sobreposicao¶
Verificar sobreposição com outros cenários.
Clima (/api/clima)¶
GET /clima/dashboard¶
Dashboard climático completo.
GET /clima/cache-status¶
Status do cache climático.
Agravos (/api/agravos)¶
GET /agravos¶
Lista todos os agravos.
POST /agravos (ADMIN)¶
Criar novo agravo.
PUT /agravos/{id} (ADMIN)¶
Atualizar (versiona automaticamente se em cenário ativo).
GET /agravos/{id}/versoes¶
Histórico de versões.
Configuração de Agravos (/api/agravos-config) (ADMIN)¶
GET /agravos-config/{id}/evidencias¶
Lista evidências.
POST /agravos-config/{id}/evidencias¶
Criar evidência.
GET /agravos-config/{id}/presumiveis¶
Lista presumíveis.
POST /agravos-config/{id}/presumiveis¶
Criar presumível.
Explorador (/api/agravos-explorer)¶
GET /agravos-explorer/tree¶
Árvore completa: agravos → presumíveis → evidências.
Usuários (/api/usuarios) (ADMIN)¶
GET /usuarios¶
Lista todos os usuários.
POST /usuarios¶
Criar novo usuário.
PUT /usuarios/{id}¶
Atualizar dados.
PUT /usuarios/{id}/senha¶
Alterar senha.
DELETE /usuarios/{id}¶
Desativar (soft delete).
Auditoria LGPD (/api/audit) (ADMIN)¶
GET /audit/summary¶
KPIs de auditoria.
GET /audit/logs¶
Timeline paginada.
POST /audit/purge¶
Purga LGPD (registros > 1 ano).
Revisão IA (/api/review)¶
GET /review/stats¶
KPIs da fila de revisão.
GET /review/queue¶
Listagem paginada.
GET /review/{id}¶
Detalhe completo.
POST /review/{id}/resolve¶
Aceitar ou rejeitar.
Geocodificação (/api/geo)¶
GET /geo/heatmap¶
Dados de heatmap por bairro.
GET /geo/cache/stats¶
Estatísticas do cache de geocodificação.
POST /geo/cache/geocode-pending (ADMIN)¶
Disparar geocodificação dos bairros pendentes.