API Cívica Oficial v2.5.1

Portal de Integração & Desenvolvedores

Conecte os sistemas de ouvidoria da sua prefeitura, ERPs municipais ou softwares de gestão parlamentar à plataforma MaisDemocracia de forma padronizada, rápida e com máxima segurança.

Autenticação & Chaves Especificação da API Boas Práticas
Quer aprender a usar a plataforma (criar reclamações, apoiar causas e propor leis)?
Acessar Guia de Uso Passo a Passo

Credenciais & Chave de Acesso

Acesso Restrito a Usuários Autenticados

Faça login com sua conta institucional ou de representante para visualizar suas credenciais de integração.

Entrar na Plataforma

Como Enviar o Cabeçalho de Autenticação

Em todas as requisições autenticadas, envie a chave de API em um dos seguintes headers HTTP:

Authorization: Bearer md_live_sua_chave_aqui X-API-Key: md_live_sua_chave_aqui

Endpoints Disponíveis

GET /api/denuncias.php Dados Abertos

Recupera a lista de demandas públicas com filtros por status, categoria, urgência e ordenação. Útil para portais de transparência municipais.

Parâmetros de Consulta (Query String):
Parâmetro Tipo Obrigatório Descrição
status string Não Filtra por: pendente, em-andamento, resolvida
categoria_id int Não ID numérico da categoria temática
limit int Não Registros por página (padrão 12, máx 100)
Exemplo de Resposta (JSON):
{ "success": true, "data": [ { "id": 42, "titulo": "Manutenção na iluminação pública da Praça Central", "categoria": "Infraestrutura", "status": "em-andamento", "urgencia": "media", "bairro": "Centro", "cidade": "São Paulo", "uf": "SP", "total_apoios": 18, "created_at": "2026-09-27T10:30:00Z" } ] }
POST /api/comentarios.php Requer Autenticação / API Key

Permite que o sistema de ouvidoria municipal envie despachos e pareceres oficiais diretamente às manifestações atribuídas à sua instituição.

Payload JSON (Body):
{ "tipo": "denuncia", "conteudo_id": 42, "comentario": "Protocolo #2026-09-A4: Equipe técnica encaminhada ao local para substituição das lâmpadas." }
POST /api/whatsapp-webhook.php Webhooks & Notificações

Permite testar e disparar alertas para servidores externos de WhatsApp (Evolution API, Z-API, n8n, etc.) cadastrados no perfil do órgão ou gabinete.

Diretrizes de Segurança & LGPD

HTTPS & Criptografia

Todas as chamadas à API devem ser realizadas obrigatoriamente sob protocolo seguro HTTPS (TLS 1.2+). Requisições em HTTP puro são rejeitadas.

Privacidade de Dados (LGPD)

A API de dados abertos não expõe CPF, senhas ou dados sensíveis de cidadãos. Manifestações anônimas preservam sigilo integral de autoria.

Rate Limiting Preventivo

Para garantir a alta disponibilidade a todos os órgãos, o sistema aplica limites automáticos de requisições por chave e por IP.