01 / Comece pela necessidade
Descoberta antes do identificador
A v2 aceita uma necessidade em linguagem natural, resolve o conceito econômico e só então apresenta conjuntos oficiais. Quando não há cobertura, a resposta diz isso explicitamente.
1. Resolva a necessidade
curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/search?q=desemprego%20desde%202015"2. Inspecione o esquema oficial
curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/datasets/ibge-aggregates%3A6381/schema"Os 32 IDs da v1 continuam estáveis; a v2 reúne 12.886 conjuntos oficiais pesquisáveis, seleção multidimensional explícita e acesso direto a dados fiscais nacionais e subnacionais, dívida pública federal, comércio exterior, preços de combustíveis, consumo de eletricidade, emprego formal e fundos de investimento.
OpenAPI v2↗ OpenAPI v1↗02 / Núcleo compartilhado
Conceito, conjunto, dimensão e observação
O conceito descreve o que a pessoa precisa, independentemente da cobertura. O conjunto mantém a identidade oficial. Medidas, classificações e geografias preservam a estrutura antes de chegar às observações.
conceptNecessidade econômica resolvidadatasetIdentidade e publicador oficiaisdimensionsRecortes selecionados explicitamenteperiodPeríodo de referência originalraw_valueValor literal da fontestatusZero, sigilo e ausência distintos03 / Semântica
Datas não são apenas rótulos
- Datas de requisição usam YYYY-MM-DD e são inclusivas.
- Séries mensais do BCB usam dia 01 como marcador do mês de referência.
- Chaves de seis dígitos do IBGE são interpretadas pela frequência.
- Trimestres móveis da PNAD se sobrepõem e não são pontos mensais.
04 / Política de revisões
A história oficial pode mudar
PIB, ajustes sazonais e outras séries podem ser revisados. O histórico é atualizado por upsert; respostas antigas não são tratadas como imutáveis.