15.4 – API-v2 – cmpinhao.org

Catálogo de Datasets

Conjuntos de dados disponíveis através da API do Portal de Dados Abertos da Câmara Municipal de Pinhão/SE.

Dataset	Formato/API	Descrição	Frequência
Vereadores	`GET /vereadores` JSON	Lista de vereadores da Câmara Municipal de Pinhão/SE, com partido, cargo e mandatos.	Atualização sempre que houver alteração no quadro de vereadores.

Documentação da API

API REST para acesso aos dados abertos da Câmara Municipal de Pinhão/SE.

URL Base

https://primary-production-0b7f.up.railway.app/webhook

GET /vereadores JSON

Retorna todos os vereadores ativos e seus detalhes.

Parâmetros (opcionais)

partido – filtrar por sigla do partido (ex: PT).
limite – número máximo de registros (padrão: 100).

Códigos de Resposta HTTP

200	OK – Requisição bem-sucedida
400	Parâmetros inválidos
404	Recurso não encontrado
500	Erro interno do servidor

Exemplos de Uso

Requisição cURL

curl -L "https://primary-production-0b7f.up.railway.app/webhook/API_CMP_Vereadores?limite=5"

Resposta JSON

{
  "vereadores": [
    {
      "nome": "Fulano da Silva",
      "partido": "ABC",
      "cargo": "Vereador(a)",
      "mandatos": ["2021-2024"]
    },
    ...
  ],
  "total": 12
}

Exemplo em Python

import requests

url = "https://primary-production-0b7f.up.railway.app/webhook/API_CMP_Vereadores"
response = requests.get(url, params={"limite":100})
response.raise_for_status()
data = response.json()
for v in data["vereadores"]:
    print(v["nome"], "-", v["partido"], "-", v["cargo"])

Especificação completa disponível em OpenAPI (YAML) • Interface interativa: Swagger UI.

Dicionário de Dados

Referência para os campos retornados pela API de Vereadores.

Estrutura do JSON

{
  "vereadores": [     // Array de objetos, cada um representando um vereador
    {
      "nome": String,     // Nome completo do vereador
      "partido": String,  // Sigla do partido político
      "cargo": String,    // Cargo na Câmara (ex: "Presidente", "Vereador")
      "mandatos": [       // Array de strings com os períodos dos mandatos
        String            // Formato: "AAAA-AAAA" (ano início - ano fim)
      ]
    },
    ...
  ]
}

Descrição dos Campos

Campo	Tipo	Descrição	Valores Possíveis
`nome`	String	Nome completo do vereador	Ex: "João da Silva Pereira"
`partido`	String	Sigla do partido político atual	Ex: "PSB", "MDB", "PL", etc.
`cargo`	String	Cargo ou função na Câmara Municipal	"Presidente", "Vice-Presidente", "1º Secretário", "2º Secretário", "Vereador"
`mandatos`	Array	Lista de períodos dos mandatos exercidos	Array contendo strings no formato "AAAA-AAAA" (ex: "2021-2024")

Exemplo Completo

{
  "vereadores": [
    {
      "nome": "Rogério Santos da Silva",
      "partido": "PSB",
      "cargo": "2º Secretário",
      "mandatos": ["2021-2024"]
    },
    {
      "nome": "Elson Fernande Souza",
      "partido": "PL",
      "cargo": "Vereador", 
      "mandatos": ["2021-2024", "2017-2020", "2013-2016"]
    },
    {
      "nome": "Edson Gil dos Santos",
      "partido": "PSB",
      "cargo": "Presidente",
      "mandatos": ["2021-2024", "2017-2020", "2013-2016"]
    }
  ]
}

Regras de Utilização e Licença

Licença CC BY 4.0

Você pode copiar, distribuir e criar obras derivadas a partir destes dados, inclusive para fins comerciais, desde que credite a Câmara Municipal de Pinhão/SE como fonte.

A Câmara isenta-se de responsabilidade por análises ou interpretações feitas por terceiros. Consulte sempre a versão mais recente nesta página.

Ver licença completa

Contato e Suporte

Para dúvidas, sugestões ou problemas com a API, entre em contato:

camaramunicipalpinhao@hotmail.com

(79) 3461-1016

Tempo de resposta: até 2 dias úteis

category Catálogo de Datasets

api Documentação da API