{"openapi":"3.1.0","info":{"title":"Vortex Legislativo — API Pública v1 (Dados Abertos e LAI)","version":"1.0.0","description":"Especificação OpenAPI 3.1 dos endpoints públicos de transparência legislativa, emendas impositivas, sessões, parlamentares e autenticidade documental da Câmara Municipal de Exemplo (Exemplópolis/EX). Opera 100% offline na rede local sem dependências externas.","contact":{"name":"Portal da Transparência — Câmara Municipal de Exemplo","email":"encarregado@exemplo.test"},"license":{"name":"Dados Abertos Governamentais — Lei nº 12.527/2011 (LAI)"}},"x-lgpd-notice":"Conformidade LAI/LGPD: todos os endpoints públicos filtram automaticamente registros RESTRITO e SIGILOSO, bem como omitem e-mails pessoais privados, credenciais e documentos de identificação civil.","servers":[{"url":"https://0.0.0.0:3000","description":"Servidor local / LAN da Câmara Municipal de Exemplo"}],"tags":[{"name":"Proposições","description":"Consulta aberta de matérias legislativas publicadas"},{"name":"Sessões e Agenda","description":"Sessões plenárias, reuniões, atas e calendário"},{"name":"Emendas Impositivas","description":"Indicações orçamentárias, execução financeira e entidades"},{"name":"Vereadores","description":"Composição parlamentar, Mesa Diretora e comissões"},{"name":"Plenário","description":"Estado instantâneo da sessão e votação para o telão"},{"name":"Autenticidade","description":"Verificação pública de recibos e assinaturas"},{"name":"Especificação","description":"Contrato OpenAPI 3.1 em formato JSON"}],"paths":{"/api/public/v1/proposicoes":{"get":{"tags":["Proposições"],"summary":"Listar proposições legislativas públicas","description":"Retorna proposições com visibilidade PUBLICO e publicadas no portal, em JSON paginado ou CSV UTF-8.","parameters":[{"name":"q","in":"query","description":"Busca textual (ignora acentos) em ementa, número ou assunto.","schema":{"type":"string"}},{"name":"year","in":"query","description":"Ano da proposição.","schema":{"type":"integer"}},{"name":"number","in":"query","description":"Número sequencial da proposição.","schema":{"type":"integer"}},{"name":"typeCode","in":"query","description":"Código da espécie legislativa (ex.: PL, IND, REQ).","schema":{"type":"string"}},{"name":"stageCode","in":"query","description":"Código da fase de tramitação atual.","schema":{"type":"string"}},{"name":"authorCouncilorId","in":"query","description":"Identificador do vereador autor.","schema":{"type":"string"}},{"name":"page","in":"query","description":"Página de resultados (padrão 1).","schema":{"type":"integer","default":1}},{"name":"format","in":"query","description":"Formato da resposta.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Lista paginada de proposições públicas ou arquivo CSV UTF-8.","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/api/public/v1/sessoes":{"get":{"tags":["Sessões e Agenda"],"summary":"Listar sessões publicadas ou agenda institucional","description":"Retorna sessões plenárias, audiências e reuniões com visibilidade PUBLICO, ou a agenda quando mode=agenda. Suporta exportação JSON e CSV.","parameters":[{"name":"mode","in":"query","description":"Use agenda para consultar eventos do calendário legislativo.","schema":{"type":"string","enum":["agenda"]}},{"name":"type","in":"query","description":"Modalidade da sessão/reunião.","schema":{"type":"string","enum":["ORDINARIA","EXTRAORDINARIA","SOLENE","ESPECIAL","ITINERANTE","COMISSAO","AUDIENCIA_PUBLICA"]}},{"name":"status","in":"query","description":"Situação da sessão.","schema":{"type":"string","enum":["AGENDADA","EM_ANDAMENTO","SUSPENSA","ENCERRADA"]}},{"name":"year","in":"query","description":"Ano da sessão.","schema":{"type":"integer"}},{"name":"q","in":"query","description":"Filtro por título, número ou local.","schema":{"type":"string"}},{"name":"format","in":"query","description":"Formato da resposta.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Lista de sessões ou eventos da agenda pública em JSON ou CSV.","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/api/public/v1/emendas":{"get":{"tags":["Emendas Impositivas"],"summary":"Consultar emendas impositivas parlamentares e execução","description":"Retorna emendas públicas com montantes indicado, empenhado, liquidado, pago, saldo, entidades destinatárias e totais consolidados.","parameters":[{"name":"q","in":"query","description":"Busca textual (ignora acentos) em objeto, número, entidade ou órgão.","schema":{"type":"string"}},{"name":"year","in":"query","description":"Exercício orçamentário.","schema":{"type":"integer"}},{"name":"councilorId","in":"query","description":"Identificador do parlamentar proponente.","schema":{"type":"string"}},{"name":"recipientEntityId","in":"query","description":"Identificador da entidade destinatária.","schema":{"type":"string"}},{"name":"status","in":"query","description":"Situação da execução financeira.","schema":{"type":"string","enum":["INDICADA","APROVADA","EMPENHADA","EM_EXECUCAO","CONCLUIDA","IMPEDIDA"]}},{"name":"area","in":"query","description":"Área temática da emenda.","schema":{"type":"string"}},{"name":"format","in":"query","description":"Formato da resposta.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Lista de emendas públicas, totais consolidados ou CSV UTF-8.","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/api/public/v1/vereadores":{"get":{"tags":["Vereadores"],"summary":"Listar vereadores ativos, Mesa Diretora e comissões","description":"Dados públicos institucionais dos parlamentares em exercício (sem e-mail privado ou documento civil). Suporta JSON e CSV.","parameters":[{"name":"q","in":"query","description":"Busca por nome parlamentar ou partido.","schema":{"type":"string"}},{"name":"party","in":"query","description":"Sigla do partido.","schema":{"type":"string"}},{"name":"mandateType","in":"query","description":"Tipo do mandato na legislatura atual.","schema":{"type":"string","enum":["TITULAR","SUPLENTE"]}},{"name":"format","in":"query","description":"Formato da resposta.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Relação de vereadores em exercício em JSON ou CSV UTF-8.","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/api/public/v1/painel":{"get":{"tags":["Plenário"],"summary":"Snapshot ao vivo do painel do plenário","description":"Fornece quórum, votação aberta, resultados apurados, cronômetro de fala e projeção ativa.","parameters":[{"name":"meetingId","in":"query","description":"ID da sessão plenária (opcional; padrão usa sessão em andamento).","schema":{"type":"string"}}],"responses":{"200":{"description":"Estado em tempo real do plenário.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/public/v1/verificar/{code}":{"get":{"tags":["Autenticidade"],"summary":"Validar código verificador de protocolo ou assinatura","description":"Verifica autenticidade de recibos e assinaturas eletrônicas; oculta dados de documentos SIGILOSO conforme a LAI.","parameters":[{"name":"code","in":"path","required":true,"description":"Código verificador impresso no recibo ou assinatura.","schema":{"type":"string"}}],"responses":{"200":{"description":"Documento ou assinatura validados.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Código não localizado."}}}},"/api/public/v1/openapi.json":{"get":{"tags":["Especificação"],"summary":"Documento OpenAPI 3.1.0 da API Pública","description":"Retorna esta especificação técnica completa em JSON.","responses":{"200":{"description":"Especificação OpenAPI 3.1.0.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}