docs/api/ENDPOINTS_CONNECTION_STATUS.md

🔌 Status Real de Conexão dos Endpoints

Autor: Anderson Henrique da Silva
Data: Outubro 2025

❌ REALIDADE: Nem todos os endpoints estão conectados!

📊 Resumo do Status Real

Status	Quantidade	Percentual	Descrição
✅ Conectado e Funcionando	~350	68%	Endpoints ativos e respondendo
🔧 Parcialmente Conectado	~100	19%	Estrutura existe mas implementação incompleta
❌ Não Conectado	~39	8%	Arquivos existem mas não estão no app.py
⚠️ Bloqueado Externamente	~30	5%	Portal da Transparência (403)

❌ Arquivos de Rotas NÃO CONECTADOS

Estes arquivos existem mas NÃO estão importados em app.py:

1. webhooks.py - Webhooks para eventos externos

# ARQUIVO EXISTE MAS NÃO ESTÁ CONECTADO!
# Endpoints definidos mas inacessíveis:
POST /api/v1/webhooks/incoming/github
POST /api/v1/webhooks/incoming/slack  
POST /api/v1/webhooks/register
GET  /api/v1/webhooks/
DELETE /api/v1/webhooks/{webhook_id}

2. monitoring.py - Monitoramento avançado SLO/SLA

# NÃO CONECTADO
GET /api/v1/monitoring/slo
GET /api/v1/monitoring/sla
POST /api/v1/monitoring/alerts

3. chaos.py - Engenharia do caos

# NÃO CONECTADO
POST /api/v1/chaos/latency
POST /api/v1/chaos/failure
POST /api/v1/chaos/cpu-spike

4. debug.py - Ferramentas de debug

# NÃO CONECTADO
GET /api/v1/debug/routes
GET /api/v1/debug/config
GET /api/v1/debug/memory

5. auth_db.py - Autenticação com banco de dados

# NÃO CONECTADO - usando auth em memória
POST /api/v1/auth/db/register
POST /api/v1/auth/db/login

🔧 Endpoints PARCIALMENTE Conectados

1. Investigations - Conectado mas retorna erro

# PROBLEMA: Retorna "temporariamente indisponível"
POST /api/v1/investigations/start  # ❌ Sempre retorna erro

2. WebSocket - Estrutura existe mas não funciona

# PROBLEMA: Implementação incompleta
WS /api/v1/ws/chat  # 🔧 Não processa mensagens corretamente

3. GraphQL - Endpoint existe mas schema incompleto

# PROBLEMA: Schema GraphQL não definido
POST /graphql  # 🔧 Retorna erro de schema

4. Alguns Agentes - Estrutura sem implementação

# Agentes que existem mas não têm lógica:
POST /api/v1/agents/dandara      # 🔧 Stub apenas
POST /api/v1/agents/lampiao      # 🔧 Stub apenas  
POST /api/v1/agents/niemeyer     # 🔧 Stub apenas

⚠️ Portal da Transparência - Bloqueios Externos

Funcionando (22%)

✅ /contratos - Requer codigoOrgao
✅ /servidores - Apenas busca por CPF
✅ /orgaos - Informações básicas

Bloqueados pelo Governo (78%)

❌ /despesas - Retorna 403
❌ /fornecedores - Retorna 403
❌ /emendas-parlamentares - Retorna 403
❌ /beneficios - Retorna 403
❌ /salarios - Retorna 403

🚀 Como Conectar os Endpoints Faltantes

1. Para conectar os arquivos não registrados:

# Em src/api/app.py, adicionar:

# Importar os routers
from src.api.routes import webhooks, monitoring, chaos, debug

# Registrar no app
app.include_router(
    webhooks.router,
    prefix="/api/v1",
    tags=["Webhooks"]
)

app.include_router(
    monitoring.router,
    prefix="/api/v1",
    tags=["Monitoring SLO/SLA"]
)

# etc...

2. Para corrigir investigations:

# O problema está na linha 273 do chat.py:
# "Enhanced Zumbi temporarily disabled"
# Já corrigimos isso mas precisa testar

3. Para implementar WebSocket:

# Implementar handlers reais em websocket_chat.py
# Adicionar lógica de processamento de mensagens

📋 Prioridades de Conexão

🔴 Alta Prioridade

1. Webhooks - Necessário para integrações
2. Monitoring SLO/SLA - Importante para produção
3. WebSocket completo - Para real-time

🟡 Média Prioridade

1. GraphQL schema - API alternativa
2. Agentes faltantes - Completar os 17
3. Debug endpoints - Útil para desenvolvimento

🟢 Baixa Prioridade

1. Chaos engineering - Para testes avançados
2. Auth DB - Sistema atual funciona

🧪 Como Verificar Status Real

# 1. Listar todas as rotas registradas
curl http://localhost:8000/openapi.json | jq '.paths | keys'

# 2. Testar endpoint específico
curl -X POST http://localhost:8000/api/v1/webhooks/test
# Se retornar 404, não está conectado!

# 3. Verificar arquivo app.py
grep -n "include_router" src/api/app.py | wc -l
# Deve mostrar quantos routers estão conectados

📊 Conclusão

• 490 endpoints estão tecnicamente "disponíveis"
• Mas apenas ~350 funcionam de verdade
• 39 endpoints existem mas não estão conectados
• ~100 endpoints estão parcialmente implementados
• Portal da Transparência tem limitações externas

Para ter TODOS funcionando, precisamos:

1. Conectar os arquivos não registrados
2. Completar implementações parciais
3. Corrigir endpoints com erro
4. Aceitar limitações do Portal da Transparência