changedOutput schema / properties / provenance / description
Previous value: -"Bloco de proveniência (contrato v1.1): fonte, URL, período, extração, diagnóstico de origem e licença"New value: +"Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença"
addedOutput schema / properties / provenance / properties / derivation_note
Added value: +{
+ "description": "O que o servidor calculou; presente junto com derived",
+ "type": "string"
+}
addedOutput schema / properties / provenance / properties / derived
Added value: +{
+ "description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE",
+ "type": "boolean"
+}
addedOutput schema / properties / provenance / properties / field_sources
Added value: +{
+ "description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração",
+ "items": {
+ "additionalProperties": false,
+ "description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
+ "properties": {
+ "data_vintage": {
+ "description": "Vintage/competência da sub-fonte",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "dataset_id": {
+ "description": "Identificador do conjunto da sub-fonte",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fields": {
+ "description": "Campos do payload atribuídos a esta sub-fonte",
+ "items": {
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "retrieved_at": {
+ "description": "ISO-8601 da extração desta sub-fonte na origem",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "served_from_cache": {
+ "description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "source_url": {
+ "description": "URL canônica da sub-fonte que originou estes campos",
+ "type": "string"
+ }
+ },
+ "required": [
+ "fields",
+ "source_url",
+ "dataset_id",
+ "data_vintage",
+ "retrieved_at"
+ ],
+ "type": "object"
+ },
+ "minItems": 1,
+ "type": "array"
+}
addedOutput schema / properties / provenance / properties / notices
Added value: +{
+ "description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso",
+ "items": {
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+}
changedOutput schema / properties / provenance / properties / retrieval / description
Previous value: -"Diagnóstico de origem desta chamada (contrato v1.1): idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"New value: +"Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
addedOutput schema / properties / provenance / properties / revision
Added value: +{
+ "additionalProperties": false,
+ "description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
+ "properties": {
+ "note": {
+ "description": "O específico da fonte: o que revisa, quando, por quê",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte",
+ "enum": [
+ "current",
+ "provisional",
+ "final"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "note"
+ ],
+ "type": "object"
+}
