API & Desenvolvedores

Tudo que o site mostra vem de uma API pública com proveniência. Os endpoints /v1/* de leitura são abertos e grátis; o tier profundo (lote e cota) usa chave. Toda resposta carrega a fonte.

Planos & preços · Painel de cota · Licenças por fonte

Base & autenticação

BASEhttps://api.dadosabedoria.org/v1

Endpoints de leitura são públicos. O tier profundo exige a chave no header — nunca em querystring nem no bundle do front.

# leitura pública — sem chave
curl https://api.dadosabedoria.org/v1/fontes

# tier profundo — exporte a chave no ambiente (export DSB_TOKEN=...), nunca inline nem versionada
curl https://api.dadosabedoria.org/v1/quota \
  -H "Authorization: Bearer $DSB_TOKEN"

Endpoints públicos

GET/v1/fontespúblico

Catálogo de fontes do acervo: domínios, cadência, atraso típico, licença e base legal.

curl https://api.dadosabedoria.org/v1/fontes

GET/v1/territorios/{codigo}/panoramapúblico

Panorama de um município pelo código IBGE — todos os indicadores do acervo, com proveniência. O protegido vem como protegido (null + motivo), nunca como zero.

curl https://api.dadosabedoria.org/v1/territorios/3550308/panorama

GET/v1/mapa/ivmpúblico

IVM por UF como GeoJSON (FeatureCollection). Onde falta a malha geométrica, a tela degrada para cartograma de tiles.

curl "https://api.dadosabedoria.org/v1/mapa/ivm?uf=SP"

Tier profundo requer chave

GET/v1/quotachave

Consumo da sua chave na janela atual (lê sem debitar). Alimenta o Painel de cota.

curl https://api.dadosabedoria.org/v1/quota \
  -H "Authorization: Bearer $DSB_TOKEN"

# 200 →
{ "limite": 1000, "usado": 342, "restante": 658, "reset": 1718000400 }

POST/v1/consultas-lotechave

Até 50 consultas por requisição — vários municípios × indicadores de uma vez. Cada item da resposta mantém sua própria proveniência e estado de supressão.

curl -X POST https://api.dadosabedoria.org/v1/consultas-lote \
  -H "Authorization: Bearer $DSB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "consultas": [
        { "indicador": "trabalho.emprego.saldo_caged", "territorio": "3550308" },
        { "indicador": "credito.operacoes.saldo_total", "territorio": "3304557" }
      ] }'

Contrato de honestidade da API. Todo número vem com fonte, periodo e lag. Dado suprimido por privacidade volta como null com motivo_supressao (k-anonimato) — nunca como zero. Sem cobertura é null sem supressão. Sua aplicação deve distinguir os dois.

Limites, preços e o que cada plano libera estão em Planos & preços. As licenças de redistribuição variam por fonte — confira em Fontes & confiança.