Acessibilidade
Alto Contraste

Ativa o contraste alto para melhor visualização.

Fonte para Dislexia

Ativa uma fonte especial para facilitar a leitura.

Aumentar Fonte

Aumenta o tamanho da fonte dos textos.

Diminuir Fonte

Reduz o tamanho da fonte dos textos.


Atalhos Rápidos

Navegue rapidamente com o teclado ou clique.


Menu Cookies
Preferências de Cookies

Cookies são pequenos arquivos de dados armazenados no seu computador ou dispositivo móvel quando você acessa nossos serviços. Eles são utilizados para melhorar sua experiência de navegação, permitindo, por exemplo, a personalização de conteúdo, a memorização de preferências e a otimização do desempenho do site. Além disso, os cookies contribuem para o funcionamento adequado de funcionalidades essenciais e facilitam a navegação entre as páginas.

GERENCIAR PREFERÊNCIAS DE CONSENTIMENTO

Câmara Municipal de Engenheiro Beltrão
acessibilidade

Regras de Utilização da API

1. Autenticação

O acesso à API exige envio de um token válido no cabeçalho da requisição.
⚠️ Use o campo: Authorization: Bearer <seu-token> e Content-Type: application/json

2. URL Base

O endpoint principal é definido como: https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/

3. Recursos Disponíveis
  • Legislação: POST /legislacao - lista leis municipais, decretos e resoluções da Câmara com filtros (busca, por_pagina)
  • Contratos: POST /contratos - filtra contratos da Câmara Municipal por termo de busca, ano (integer), situação (ativo ou inativo)
  • Obras: POST /obras - permite pesquisar obras do Legislativo Municipal com filtros como termo, status e período
4. Formato da Resposta

Todas as respostas estão no formato JSON com estrutura padronizada incluindo: success, message, data e pagination.

5. Códigos HTTP Utilizados
  • 200 – Sucesso
  • 201 – Criado com sucesso
  • 400 – Erro de validação
  • 401 – Não autorizado
  • 404 – Não encontrado
  • 500 – Erro interno do servidor
6. Diretrizes Específicas - Engenheiro Beltrão
  • Utilize somente dados públicos legislativos em formatos abertos, conforme Lei de Acesso à Informação (Lei nº 12.527/2011)
  • Respeite limites e filtros dos endpoints, evitando sobrecarga no sistema da Câmara Municipal
  • Mantenha seu token seguro e evite compartilhá-lo em público
  • Trate erros HTTP corretamente, implementando lógica de re-tentativa conforme necessário
  • É obrigatório citar a fonte dos dados como "Portal da Transparência da Câmara Municipal de Engenheiro Beltrão" em qualquer uso
  • O usuário é responsável integralmente pelo uso dos dados legislativos obtidos através da API
  • Os dados seguem as diretrizes do Tribunal de Contas do Estado do Paraná
  • Para dúvidas técnicas, entre em contato com a Secretaria Administrativa da Câmara Municipal de Engenheiro Beltrão
Resumo das Principais Regras
  • Token único: Sempre enviado em cabeçalho (Authorization)
  • Base URL: https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/
  • Endpoints ativos: legislação, contratos, obras
  • Resposta JSON: Inclui success, message, data, pagination
  • Status HTTP: 200, 201, 400, 401, 404, 500
  • Órgão: Câmara Municipal de Engenheiro Beltrão - PR
Palavras-chave: API, Câmara Municipal, Engenheiro Beltrão, transparência legislativa, Paraná

Documentação da API - Portal da Transparência

Câmara Municipal de Engenheiro Beltrão

Esta documentação descreve os endpoints disponíveis na API do Portal da Transparência da Câmara Municipal de Engenheiro Beltrão e como utilizá-los para acessar dados legislativos públicos.

URL Base da API
https://api.transparencia.cmbeltrao.pr.leg.br/api/v1

Autenticação

Todas as requisições devem incluir o token no header:

Authorization Bearer 8117P2pcvhdvOy4ow4AKXUgKTQfIERtwT

Legislação

POST /legislacao

Lista todas as legislações municipais com filtros de busca.

Parâmetros
Campo Tipo Descrição
busca string Termo para busca
por_pagina integer Itens por página (default: 10)
Exemplo
                    curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/legislacao \
                            -H "Authorization: Bearer seu-token" \
                            -H "Content-Type: application/json" \
                            -d '{
                                    "busca": "lei",
                                    "por_pagina": 10
                            }'
POST /legislacao/detalhe

Retorna detalhes de uma legislação específica.

Parâmetros
Campo Tipo Descrição
id integer ID da legislação
Exemplo
                    curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/legislacao/detalhe \
                            -H "Authorization: Bearer seu-token" \
                            -H "Content-Type: application/json" \
                            -d '{
                                    "id": 1
                            }'

Contratos

POST /contratos

Lista todos os contratos da Câmara com filtros.

Parâmetros
Campo Tipo Descrição
busca string Termo para busca
ano integer Ano do contrato
situacao string Status do contrato (ativo/inativo)
Exemplo
curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/contratos \
     -H "Authorization: Bearer seu-token" \
     -H "Content-Type: application/json" \
     -d '{
         "busca": "construção",
         "ano": 2025,
         "situacao": "ativo"
     }'
POST /contratos/detalhe

Retorna detalhes de um contrato específico.

Parâmetros
Campo Tipo Descrição
id integer ID do contrato
Exemplo
curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/contratos/detalhe \
     -H "Authorization: Bearer seu-token" \
     -H "Content-Type: application/json" \
     -d '{
         "id": 1
     }'

Obras

POST /obras

Lista todas as obras do Legislativo Municipal com filtros.

Parâmetros
Campo Tipo Descrição
busca string Termo para busca no título
situacao string Status da obra (em_andamento/concluida/paralisada)
data_inicial date Data inicial (Y-m-d)
data_final date Data final (Y-m-d)
Exemplo
curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/obras \
     -H "Authorization: Bearer seu-token" \
     -H "Content-Type: application/json" \
     -d '{
         "busca": "pavimentação",
         "situacao": "em_andamento",
         "data_inicial": "2025-01-01"
     }'
POST /obras/detalhe

Retorna detalhes de uma obra específica.

Parâmetros
Campo Tipo Descrição
id integer ID da obra
Exemplo
curl -X POST https://api.transparencia.cmbeltrao.pr.leg.br/api/v1/obras/detalhe \
     -H "Authorization: Bearer seu-token" \
     -H "Content-Type: application/json" \
     -d '{
         "id": 1
     }'

Formato das Respostas

{
                                "success": true/false,
                                "message": "Mensagem descritiva",
                                "data": {
                                    // Dados da resposta
                                },
                                "pagination": {
                                    "total": 100,
                                    "per_page": 10,
                                    "current_page": 1,
                                    "last_page": 10
                                }
                            }

Códigos de Status HTTP

Código Descrição
200 Sucesso
201 Criado com sucesso
400 Erro de validação
401 Não autorizado
404 Não encontrado
500 Erro interno do servidor