Dados de países

Previous value: -"IDs dos indicadores separados por | (ex: 77819|77820)"New value: +"Indicadores a trazer no modo detalhes, separados por | — IDs ou apelidos (ex: 77819|77820 ou idh|populacao). Lista completa: tipo='indicadores'. Sem este parâmetro: população, PIB, PIB per capita, IDH e esperança de vida"

Previous value: -"Indicadores disponíveis para consulta de países (modo indicadores)"New value: +"Catálogo de indicadores de países publicado pelo IBGE (modo indicadores)"

Previous value: -"Apelido amigável do indicador"New value: +"O que passar no parâmetro `indicadores`: o apelido (ex.: 'idh'), ou o próprio ID quando o indicador não tem apelido"

Added value: +{
+  "description": "Escala dos valores; null se a fonte não informa",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Previous value: -"Nome do indicador"New value: +"Nome do indicador, como a fonte o publica"

Added value: +{
+  "description": "Unidade do indicador; null se a fonte não informa",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -[
-  "id",
-  "nome",
-  "alias"
-]New value: +[
+  "id",
+  "nome",
+  "alias",
+  "unidade",
+  "multiplicador"
+]

Previous value: -"Indicadores principais com o valor mais recente disponível"New value: +"Indicadores pedidos, cada um com o valor mais recente publicado"

Previous value: -"Ano de referência do valor"New value: +"Ano ou período (ex.: '2021-2023') do valor"

Added value: +{
+  "description": "ID do indicador na API do IBGE",
+  "type": "number"
+}

Previous value: -"Nome do indicador"New value: +"Nome do indicador, como a fonte o publica"

Added value: +{
+  "description": "Escala do valor (ex.: 1000000000 = valor em bilhões da unidade); null se a fonte não informa",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Unidade do valor (ex.: 'US$', '% do PIB'); null se a fonte não informa",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Valor mais recente do indicador"New value: +"Valor mais recente publicado, como texto da fonte (pode ser não numérico, ex.: '<2.5')"

Previous value: -[
-  "indicador",
-  "valor",
-  "ano"
-]New value: +[
+  "id",
+  "indicador",
+  "valor",
+  "ano",
+  "unidade",
+  "multiplicador"
+]

Added value: +{
+  "description": "Indicadores pedidos para os quais a fonte não publica valor algum para o país (série inteira em branco) — ausência na fonte, não zero",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "description": "ID do indicador na API do IBGE",
+        "type": "number"
+      },
+      "indicador": {
+        "description": "Nome do indicador, como a fonte o publica",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "indicador"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

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

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

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

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

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "string",
+  "null"
+]

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "string",
+  "null"
+]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Removed value: -false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
+    },
+    "license": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Regime legal do dado"
+    },
+    "retrieved_at": {
+      "description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado (API do IBGE consultada)",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

Previous value: -[
-  "tipo"
-]New value: +[
+  "tipo",
+  "provenance",
+  "attribution"
+]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "busca": {
+      "description": "Termo de busca aplicado, se houver",
+      "type": "string"
+    },
+    "indicadores": {
+      "description": "Indicadores disponíveis para consulta de países (modo indicadores)",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "alias": {
+            "description": "Apelido amigável do indicador",
+            "type": "string"
+          },
+          "id": {
+            "description": "ID do indicador na API do IBGE",
+            "type": "number"
+          },
+          "nome": {
+            "description": "Nome do indicador",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "nome",
+          "alias"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "pais": {
+      "additionalProperties": false,
+      "description": "Detalhes de um país específico (modo detalhes)",
+      "properties": {
+        "areaTotalKm2": {
+          "description": "Área territorial total em km²",
+          "type": "number"
+        },
+        "historico": {
+          "description": "Texto histórico sobre o país",
+          "type": "string"
+        },
+        "indicadores": {
+          "description": "Indicadores principais com o valor mais recente disponível",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "ano": {
+                "description": "Ano de referência do valor",
+                "type": "string"
+              },
+              "indicador": {
+                "description": "Nome do indicador",
+                "type": "string"
+              },
+              "valor": {
+                "description": "Valor mais recente do indicador",
+                "type": "string"
+              }
+            },
+            "required": [
+              "indicador",
+              "valor",
+              "ano"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "isoAlpha2": {
+          "description": "Código ISO-ALPHA-2",
+          "type": "string"
+        },
+        "isoAlpha3": {
+          "description": "Código ISO-ALPHA-3",
+          "type": "string"
+        },
+        "linguas": {
+          "description": "Línguas faladas no país",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "m49": {
+          "description": "Código M49 do país",
+          "type": "number"
+        },
+        "moedas": {
+          "description": "Unidades monetárias do país",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "description": "Código da unidade monetária",
+                "type": "string"
+              },
+              "nome": {
+                "description": "Nome da unidade monetária",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "nome"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "nome": {
+          "description": "Nome do país",
+          "type": "string"
+        },
+        "regiao": {
+          "description": "Nome da região/continente",
+          "type": "string"
+        },
+        "regiaoIntermediaria": {
+          "description": "Nome da região intermediária",
+          "type": "string"
+        },
+        "subRegiao": {
+          "description": "Nome da sub-região",
+          "type": "string"
+        }
+      },
+      "required": [
+        "nome",
+        "m49",
+        "isoAlpha2",
+        "isoAlpha3"
+      ],
+      "type": "object"
+    },
+    "paises": {
+      "description": "Lista de países (modos listar/buscar). Limitada aos 50 primeiros na exibição",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "codigo": {
+            "description": "Código ISO-ALPHA-2 do país (ou '-' se ausente)",
+            "type": "string"
+          },
+          "nome": {
+            "description": "Nome do país",
+            "type": "string"
+          },
+          "regiao": {
+            "description": "Nome da região/continente (ou '-' se ausente)",
+            "type": "string"
+          },
+          "subRegiao": {
+            "description": "Nome da sub-região (ou '-' se ausente)",
+            "type": "string"
+          }
+        },
+        "required": [
+          "codigo",
+          "nome",
+          "regiao",
+          "subRegiao"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "regiao": {
+      "description": "Filtro de região/continente aplicado, se houver",
+      "type": "string"
+    },
+    "tipo": {
+      "description": "Modo de consulta que originou este resultado",
+      "enum": [
+        "listar",
+        "buscar",
+        "detalhes",
+        "indicadores"
+      ],
+      "type": "string"
+    },
+    "total": {
+      "description": "Total de países encontrados (modos listar/buscar)",
+      "type": "number"
+    }
+  },
+  "required": [
+    "tipo"
+  ],
+  "type": "object"
+}