changedOutput schema / properties / provenance / description
Previous value: -"Bloco de proveniência (contrato v1.1): fonte, URL, competência, extração, diagnóstico de origem, citação e licença"New value: +"Bloco de proveniência: fonte, URL, competência, extração, diagnóstico de origem, citação e licença; e, só quando há o que dizer, de onde veio cada parte, avisos da fonte, o que o servidor calculou e se o dado ainda pode mudar"
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 em vez de repassá-lo como veio da fonte",
+ "type": "boolean"
+}
addedOutput schema / properties / provenance / properties / field_sources
Added value: +{
+ "description": "Presente só quando a resposta junta partes de origens ou momentos distintos: para cada grupo de campos, a URL, a extração e se veio do cache. Ausente nas respostas de uma origem só",
+ "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 a fonte publica junto com o dado (quebra de série, unidade, frescor), verbatim. Ausente quando não há aviso",
+ "items": {
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+}
changedOutput schema / properties / provenance / properties / retrieved_at / description
Previous value: -"Instante REAL da extração na origem (ISO-8601, fuso do servidor). Resposta servida de cache mantém o instante do fetch original, que é a data de extração relevante"New value: +"Instante REAL da extração na origem (ISO-8601, fuso do servidor). Resposta servida de cache mantém o instante do fetch original, que é a data de extração relevante. Quando a resposta junta partes extraídas em momentos distintos, é o MAIS ANTIGO deles (field_sources diz cada um)"
addedOutput schema / properties / provenance / properties / revision
Added value: +{
+ "additionalProperties": false,
+ "description": "Se o dado ainda pode mudar na fonte",
+ "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"
+}