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"

Added value: +{
+  "description": "O que o servidor calculou; presente junto com derived",
+  "type": "string"
+}

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"
+}

Previous value: -"Proveniência por sub-fonte (contrato v1.2): 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"New value: +"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"

Added value: +"Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído"

Added value: +"Vintage/competência da sub-fonte"

Added value: +"Identificador do conjunto da sub-fonte"

Added value: +"Campos do payload atribuídos a esta sub-fonte"

Added value: +"ISO-8601 da extração desta sub-fonte na origem"

Added value: +"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"

Added value: +"URL canônica da sub-fonte que originou estes campos"

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"
+}

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)"

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"
+}

Added value: +{
+  "description": "Proveniência por sub-fonte (contrato v1.2): 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,
+    "properties": {
+      "data_vintage": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "dataset_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "fields": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "retrieved_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "served_from_cache": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "source_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "fields",
+      "source_url",
+      "dataset_id",
+      "data_vintage",
+      "retrieved_at"
+    ],
+    "type": "object"
+  },
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -"Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença"New value: +"Bloco de proveniência (contrato v1.1): fonte, URL, período, extração, diagnóstico de origem e licença"

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "anomalies": {
+          "description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "count": {
+                "description": "Ocorrências desta classe na chamada",
+                "maximum": 9007199254740991,
+                "minimum": 1,
+                "type": "integer"
+              },
+              "kind": {
+                "description": "Classe da anomalia (vocabulário fechado do contrato)",
+                "enum": [
+                  "timeout",
+                  "network",
+                  "http_4xx",
+                  "http_5xx",
+                  "rate_limited",
+                  "malformed_body"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind",
+              "count"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "attempts": {
+          "description": "Tentativas somadas, incluindo as repetidas (>= requests)",
+          "maximum": 9007199254740991,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "requests": {
+          "description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)",
+          "maximum": 9007199254740991,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "unstable": {
+          "description": "true se houve repetição (attempts > requests) ou alguma anomalia",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "requests",
+        "attempts",
+        "anomalies",
+        "unstable"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "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)"
+}

Previous value: -[
-  "source",
-  "source_url",
-  "data_vintage",
-  "retrieved_at",
-  "citation",
-  "license"
-]New value: +[
+  "source",
+  "source_url",
+  "data_vintage",
+  "retrieved_at",
+  "retrieval",
+  "citation",
+  "license"
+]

Added value: +false

Previous value: -"Código específico do tema (ex: código do bioma, da região metropolitana)"New value: +"Filtra uma feição do recorte. Só os recortes que têm código próprio aceitam: biomas (cd_bioma, ex. \"1\") e os dois de municípios, costeiro e fronteira (código IBGE de 7 dígitos). Nos demais a chamada é recusada com a lista do que aceita."

Removed value: -{
-  "default": "geojson",
-  "description": "Formato de saída",
-  "enum": [
-    "geojson",
-    "topojson",
-    "svg"
-  ],
-  "type": "string"
-}

Added value: +{
+  "default": 50,
+  "description": "Quantas feições trazer (padrão 50, máx. 600). O total do recorte vem sempre, mesmo quando o limite corta a lista.",
+  "maximum": 600,
+  "minimum": 1,
+  "type": "integer"
+}

Removed value: -{
-  "default": "4",
-  "description": "Qualidade do traçado: 1=mínima, 4=máxima",
-  "enum": [
-    "1",
-    "2",
-    "3",
-    "4"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "default": "0",
-  "description": "0 = Apenas contorno, 5 = Com municípios",
-  "enum": [
-    "0",
-    "5"
-  ],
-  "type": "string"
-}

Previous value: -"Tema da malha:\n- biomas: Biomas brasileiros (Amazônia, Cerrado, etc.)\n- amazonia_legal: Área da Amazônia Legal\n- semiarido: Região do semiárido\n- costeiro: Zona costeira\n- fronteira: Faixa de fronteira\n- metropolitana: Regiões metropolitanas\n- ride: Regiões Integradas de Desenvolvimento\n- listar: Lista temas disponíveis"New value: +"Recorte temático do território:\n- biomas: os seis biomas continentais\n- amazonia_legal: limite da Amazônia Legal\n- semiarido: área do semiárido\n- costeiro: municípios da zona costeira\n- fronteira: municípios da faixa de fronteira\n- metropolitana: regiões metropolitanas\n- ride: Regiões Integradas de Desenvolvimento\n- listar: lista os recortes disponíveis, sem consultar a fonte"

Added value: +{
+  "description": "Camada WFS do IBGE Geosserviços consultada",
+  "type": "string"
+}

Previous value: -"Código específico do tema, quando informado"New value: +"Código usado como filtro, quando informado"

Added value: +{
+  "description": "Total de feições do recorte na fonte",
+  "type": "number"
+}

Added value: +{
+  "description": "Quantas vieram nesta resposta",
+  "type": "number"
+}

Removed value: -{
-  "description": "Formato de saída (geojson, topojson, svg)",
-  "type": "string"
-}

Added value: +{
+  "description": "Atributos de cada feição (sem geometria)",
+  "items": {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "Resolução da malha (0 = contorno, 5 = com municípios)",
-  "type": "string"
-}

Previous value: -"Tema da malha solicitada (ou 'listar')"New value: +"Recorte solicitado (ou 'listar')"

Previous value: -"Lista de temas disponíveis (somente no modo 'listar')"New value: +"Lista de recortes disponíveis (somente no modo 'listar')"

Previous value: -"Descrição do tema"New value: +"Descrição do recorte"

Previous value: -"Nome do tema"New value: +"Nome do recorte"

Previous value: -"Identificador do tema"New value: +"Identificador do recorte"

Added value: +{
+  "description": "URL canônica do WFS que devolve a malha COM geometria, em GeoJSON",
+  "type": "string"
+}