Manual de Operação

Especificações técnicas para a extração de dados da malha municipal via API GraphQL do SIDM.

1.0 Ponto de Acesso

O endpoint único de GraphQL disponível publicamente.

/// ENDPOINT HTTPS

https://sidm-api.cfiorimartins.workers.dev/graphql

2.0 Queries Principais

Métodos de acesso direto aos dados.

`municipio(codigoIbge: Int!)`

Busca os dados completos de um único município a partir do seu código IBGE (7 dígitos).

query { 
  municipio(codigoIbge: 3550308) { 
    nome 
    siglaUf 
  } 
}

`municipios(nome: String, uf: String, pagina: Int)`

Retorna uma lista paginada de municípios, permitindo filtragem textual e geográfica.

`rankingPib(ano: Int!, uf: String, limite: Int, constante: Boolean)`

Gera um ranking ordenado dos municípios mais ricos com base em um ano específico. Se constante for true, utiliza o PIB deflacionado.

`compararPib(codigos: [Int!]!)`

Compara múltiplos municípios lado a lado em uma única requisição GraphQL para uma mesma janela temporal.

3.0 Estrutura de Tipos

A raiz de toda consulta espacial e demográfica é o objeto Municipio.

/// TYPE: Municipio

type Municipio {
  codigoIbge: Int!
  nome: String!
  siglaUf: String!
  populacao: Int
  pib(ano: Int, anoInicio: Int, anoFim: Int): [PibMunicipal!]!
  regiao: RegiaoInfo!
}

/// TYPE: PibMunicipal

type PibMunicipal {
  ano: Int!
  pibCorrente: Float        # PIB a preços correntes (nominais)
  pibReal: Float            # PIB deflacionado (Base 2021 = 100)
  pibPerCapitaReal: Float   # PIB per capita deflacionado
}

4.0 Metadados

Informações auxiliares e fatores de cálculo.

`fontes`

Lista URLs oficiais, módulo e datas de atualização das bases extraídas do IBGE.

`deflatores`

Retorna a tabela completa de Deflatores Implícitos do PIB utilizados para calcular a coluna pibReal.