{"openapi":"3.1.0","info":{"title":"Changelog Brasil — dados públicos","version":"1.0.0","description":"Leis, governos e representantes de cada estado, cidade, distrito e bairro do Brasil — com dados abertos oficiais. Leitura livre, sem chave. Cada item aponta para o registro oficial de onde veio."},"servers":[{"url":"https://changelogbrasil.com"}],"externalDocs":{"description":"Mapa do site para assistentes de IA","url":"https://changelogbrasil.com/llms.txt"},"paths":{"/api/search-index":{"get":{"operationId":"listPlaces","summary":"Todos os estados e municípios, para busca","description":"Lista completa dos 27 estados e dos municípios do IBGE com o endereço da página de cada um. Atualizada uma vez por semana.","responses":{"200":{"description":"Estados e municípios.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IndexEntry"}}}}}}}},"/api/lugares":{"get":{"operationId":"placeFromCep","summary":"O que dá para acompanhar em um município e bairro","description":"Recebe o código IBGE do município e, opcionalmente, o nome do bairro (por exemplo, como o ViaCEP responde) e diz se as leis do estado e o diário oficial da cidade podem ser lidos e qual página do site corresponde ao bairro.","parameters":[{"name":"municipio","in":"query","required":true,"description":"Código IBGE do município, com 7 dígitos.","schema":{"type":"string","pattern":"^\\d{7}$"},"example":"3509502"},{"name":"bairro","in":"query","required":false,"description":"Nome do bairro.","schema":{"type":"string","maxLength":120},"example":"Cambuí"}],"responses":{"200":{"description":"O município e o bairro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceTargets"}}}},"400":{"description":"Código de município inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Município não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Fonte de dados indisponível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/congresso/rss.xml":{"get":{"summary":"Decisões do Congresso","description":"Votações do Plenário da Câmara e deliberações do Senado, com o resultado de cada uma.","parameters":[],"responses":{"200":{"description":"Feed RSS 2.0 em UTF-8.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/deputados/{id}/rss.xml":{"get":{"summary":"Projetos de um deputado federal","description":"Projetos de lei, PLPs, PECs e PDLs de autoria ou coautoria. O id é o mesmo da Câmara e aparece na página de cada deputado.","parameters":[{"name":"id","in":"path","required":true,"description":"Id do deputado na Câmara dos Deputados.","schema":{"type":"string"},"example":"204536"}],"responses":{"200":{"description":"Feed RSS 2.0 em UTF-8.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/senadores/{id}/rss.xml":{"get":{"summary":"Projetos de um senador","description":"Matérias de autoria ou coautoria, com a situação oficial e a indicação de autor principal.","parameters":[{"name":"id","in":"path","required":true,"description":"Código do senador no Senado Federal.","schema":{"type":"string"},"example":"5672"}],"responses":{"200":{"description":"Feed RSS 2.0 em UTF-8.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/{uf}/rss.xml":{"get":{"summary":"Leis e projetos de um estado","description":"Normas estaduais e projetos apresentados na assembleia, nos estados cuja assembleia publica dados abertos no SAPL.","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado em minúsculas.","schema":{"type":"string"},"example":"sp"}],"responses":{"200":{"description":"Feed RSS 2.0 em UTF-8.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/{uf}/{cidade}/rss.xml":{"get":{"summary":"Leis de uma cidade","description":"Leis sancionadas encontradas no diário oficial do município, nas cidades com busca em texto no Querido Diário.","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado em minúsculas.","schema":{"type":"string"},"example":"sp"},{"name":"cidade","in":"path","required":true,"description":"Nome da cidade sem acentos, em minúsculas e com hífens.","schema":{"type":"string"},"example":"campinas"}],"responses":{"200":{"description":"Feed RSS 2.0 em UTF-8.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/embed/{uf}/{cidade}":{"get":{"operationId":"cityLawsWidget","summary":"Quadro “Últimas leis” de uma cidade","description":"HTML sem JavaScript para colar em um iframe. Ver /widget.","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado em minúsculas.","schema":{"type":"string"},"example":"sp"},{"name":"cidade","in":"path","required":true,"description":"Nome da cidade sem acentos, em minúsculas e com hífens.","schema":{"type":"string"},"example":"campinas"}],"responses":{"200":{"description":"O quadro.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/embed/{uf}":{"get":{"operationId":"stateLawsWidget","summary":"Quadro “Últimas leis” de um estado","description":"HTML sem JavaScript para colar em um iframe. Ver /widget.","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado em minúsculas.","schema":{"type":"string"},"example":"sp"}],"responses":{"200":{"description":"O quadro.","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"IndexEntry":{"type":"object","required":["n","u","s","t"],"properties":{"n":{"type":"string","description":"Nome do estado ou município."},"u":{"type":"string","description":"Sigla do estado."},"s":{"type":"string","description":"Trecho do endereço: a UF em minúsculas (estado) ou o nome da cidade em minúsculas e com hífens."},"t":{"type":"string","enum":["s","m"],"description":"s = estado, m = município."},"c":{"type":"integer","enum":[1],"description":"Presente quando o município é capital."}}},"PlaceTargets":{"type":"object","required":["uf","stateLawsReadable","city","neighbourhood"],"properties":{"uf":{"type":"string"},"stateLawsReadable":{"type":"boolean","description":"As leis do estado vêm de uma base atualizada."},"city":{"type":["object","null"],"properties":{"code":{"type":"integer","description":"Código IBGE."},"name":{"type":"string"},"slug":{"type":"string"},"searchable":{"type":"boolean","description":"O diário oficial tem busca em texto no Querido Diário."}}},"neighbourhood":{"type":["object","null"],"properties":{"name":{"type":"string"},"href":{"type":["string","null"],"description":"Página do bairro ou distrito no site, quando existe."}}}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}