Consumo por agentes e integrações

Conteúdo estruturado para sistemas, LLMs e automações.

Esta página descreve os endpoints estáveis, a semântica dos campos e os limites de uso para agentes consumirem o conteúdo com baixa ambiguidade.

Abrir agent.json Abrir llms.txt

Endpoints recomendados

/v1/high-alertsAlertas altos e críticos por município, doença e vírus. /v1/risk-indexÍndice enriquecido com filtros por município, UF e nível mínimo. /v1/diseasesCatálogo de doenças e agravos suportados pela API. /v1/bairrosLista agrupada de bairros/distritos (SP, RJ, MG, PE) para busca por nome (resolve para município). /v1/metadataFontes, ano, status da carga e fórmula de risco. /openapi.jsonContrato OpenAPI para geração de clientes e ferramentas.

Exemplo

GET /v1/high-alerts?estado=SP&limite=10
GET /v1/risk-index?municipio=perus&estado=SP&somente_altos=false

Regras de interpretação

Use nivel_risco_fonte_atual para priorizar ação de hoje e incidencia.por_100k para comparar municípios: é a única medida que não depende do tamanho da cidade. risk_score é soma de contagens absolutas e correlaciona 0,82 com a população — ordene por ele apenas quando a pergunta for "onde há mais casos", nunca "onde é pior".

Cada agravo declara fonte.ano, o ano do arquivo SINAN de onde veio, e recencia.frescor, medido dentro dessa fonte. O relatório reúne anos diferentes por agravo: verifique fonte.do_ano_corrente antes de datar qualquer afirmação. /v1/diseases lista os agravos carregados.

filtro_localidade aparece quando a consulta foi feita por bairro ou distrito. O sistema resolve o nome para o município — a granularidade dos dados continua municipal.

Bairros e distritos suportados (multi-cidade)

O sistema resolve nomes de bairros e distritos para o município oficial (granularidade sempre municipal). Atualmente suportamos São Paulo (distritos), Rio de Janeiro, Belo Horizonte e Recife. Ao usar um destes nomes no parâmetro municipio, a resposta inclui filtro_localidade com a origem da consulta.

Exemplos de buscas que funcionam:

alto de pinheirosanhanguerabangubarra da tijucabelvedereburitisboa viagemcandeias

Nomes ambíguos: campo grande, penha existem em mais de uma cidade suportada. Informe estado para escolher; sem ele a resposta traz filtro_localidade.ambiguidade com as alternativas.

Lista completa e estruturada: GET /v1/bairros (retorna todas as cidades com seus bairros em formato agrupado).

Prefira o nome do bairro quando estiver em campo: o sistema entrega os dados do município com o contexto da origem.