Pular para o conteúdo

Dados abertos

API de Transparência

Os dados de transparência de Instituto Nós do Brejo também são publicados em formato aberto (JSON), para que outros sistemas os consumam diretamente, sem precisar copiar do site. O uso é livre, com indicação da fonte.

Recursos disponíveis
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/entidade
Identificação da organização, contato público e encarregado de dados.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/projetos
Projetos marcados como públicos, com descrição e situação.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/despesas
Despesas pagas e publicadas. Filtros: data_inicio, data_fim, projeto_id, busca.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/receitas
Receitas dos projetos públicos, com a fonte do recurso.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/contratos
Contratos publicados, com objeto, contratado e vigência.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/licitacoes
Editais de compra e a situação de cada um. Filtro: status.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/patrimonio
Bens patrimoniais divulgados.
GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/balancos
Exercícios com balanço homologado.
Descoberta automática

Estes dois endereços não exigem chave — descobrir o que existe é parte de publicar dados abertos:

GET https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/manifesto
Catálogo dos conjuntos, licença de uso e regras de proteção de dados.
GET https://app.socialsys.com.br/api/v1/transparencia/openapi
Especificação OpenAPI 3.0 — importe no Postman ou gere um cliente pronto.
Como chamar
curl -H "X-API-Key: sua_chave" \
  https://app.socialsys.com.br/api/v1/transparencia/nosdobrejo/despesas?pagina=1&por_pagina=100
Paginação e limites

Use pagina e por_pagina (até 500). Toda resposta traz um bloco paginacao com o total de registros. O limite é de 5.000 requisições por dia; os cabeçalhos X-RateLimit-Remaining indicam quanto resta.

Proteção de dados

A API publica a aplicação dos recursos, não pessoas. Beneficiários de programas sociais não são identificados, CPF sai mascarado e CNPJ sai íntegro. Cada recurso declara os campos que publica — nenhuma resposta devolve registros do banco por inteiro. Veja a política de privacidade.

Obter uma chave

O acesso é gratuito e imediato — não há aprovação. O cadastro existe para que a organização saiba quem consulta seus dados, como manda a prestação de contas.