Child pages
  • API Statistics - Migration von JSON Webservice zu API Statistics

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Alle Visualisierungsanwendungen müssen migriert werden, um den DissChain WDDS Translator verwenden zu können.

Bei der Migration muss Folgendes berücksichtigt werden:

  • Es gibt Methoden und Parameter, die außer Kraft genommen werden. Weitere Informationen finden Sie in diesem Kapitel.

  • Es gibt Unterschiede im JSON-Format. Weitere Informationen finden Sie in diesem Kapitel.

Unterschiede zwischen den WDDS-Versionen 1.1 und 2.1

Erste Änderung

Einer der Hauptunterschiede zwischen den beiden Versionen ist die Verwendung von Positionsparametern in 1.1 gegenüber benannten Parametern in 2.1, bei denen die Nullwerte nicht angezeigt werden. In Version 2.1 wird ein Index zum Sortieren der Werte bereitgestellt. Beide Änderungen helfen bei der Bereitstellung einer schnelleren / gefilterten Antwort.

Einige andere Änderungen, die im Ausgangszustand durchgeführt wurden:

  • "title" wurde im Stammverzeichnis in "label" umbenannt

  • "updated" wird anstelle von "lastUpdateDate" verwendet

  • Alle nicht standardmäßigen Eigenschaften (Dataset-ID, Sprache, Agentur, Beschreibung, Status) wurden in den Abschnitt "Erweiterung" verschoben

  • Der Standard „status“-Eigenschaft wurde aktualisiert und enthält nun alle Metadateninformationen auf Beobachtungsebene

  • Die möglichen Werte für "class" wurden aktualisiert und enthalten nun die Antwort "dataset" anstelle von "bundle" ("bundle" war vor Version 2.0 ein akzeptierter Wert)

JSON-stat Änderungen

  • JSON-stat 2.0-Unterstützung in WDDS:

    Die Eigenschaft "version" wurde mit dem Wert 2

    .

    0 hinzugefügtDie Eigenschaften "id", "size" und "role" wurden von der Dimensionsebene auf die Dataset-Ebene verschoben

  • JSON-stat-Statuseigenschaft:

    • Die Eigenschaft "status" wird nicht angezeigt, wenn sie keine Informationen enthält

  • Änderung der JSON-stat-Fehlermeldung für zu umfangreiche Extraktionen:

    • „Too many categories have been requested. Maximum is 50" Fehlermeldung wird angezeigt, falls der abzurufende Extraktion zu groß ist. Es ersetzt die vorherige Fehlermeldung "Maximum 50 datasets can be retrieved at a time" oder der Antwort des Abfrage-Generators "Maximum 50 sub-indicators can be retrieved at a time. Please filter your selection”

  • JSON-stat-Fehlerspezifikation:

    • Die übermittelte Fehlermeldung ist im JSON-Format anstelle von einfachem Text. Die Fehlerelemente sind:

      • status: Der HTTP-Statuscode

      • id: Der interne Fehlercode des Anbieters (optional)

      • href: Ein Link zu einer Webseite, auf der Informationen zu diesem Fehler veröffentlicht werden (optional)

      • label: Ein kurzer beschreibender Text zum Fehler

Beispiel:

Code Block
{ "error": [\{"status": 400,"id": 100,"label": "NO_RESULTS: No data found"}]}
  • Das JSON-stat HREF-Element enthält alle Parameter:

    • Die HREF-Eigenschaft im Stammverzeichnis enthält die URL der Anforderung

  • JSON-stat “updated” Eigenschaft contains a date instead of timestamp:

  • Die JSON-stat-Eigenschaft "updated" enthält ein Datum anstelle eines Zeitstempels:

    • Wenn keine Uhrzeit angegeben ist, sollte der Wert von "updated" ein Datum und keinen Zeitstempel mit 0 für die Uhrzeit festgelegten Werten enthalten

  • Der JSON-stat-Quellwert ist "Eurostat" anstelle von "ESTAT".

Anchor
DECOMMISSION
DECOMMISSION
Methoden, Parameter und Elemente, die in

...

API Statistics außer Betrieb genommen werden sollen

In der folgenden Tabelle sind die Methoden, Parameter und Elemente aufgeführt, die in RENOV WDDS Translator in API Statistics außer Betrieb genommen werden:

...

Die Methoden und Parameter, die an den RENOV WDDS-Translator die API Statistics weitergegeben werden, sind:

  • lastTimePeriod

  • sinceTimePeriod

  • untilTimePeriod

  • geoLevel, kann mehrere sein und verfügbare Werte sind:

    • aggregate: Europäische Aggregate basierend auf einer weißen Liste – EU15, EU25, EU27_2007, EU27_2019, EU28, EA19 usw.

    • country: beliebiger Ländercode (EU-Mitgliedstaaten oder EFTA- oder Kandidatenländer oder andere Länder) – zwei beliebige Ziffern – d. h. FR

    • nuts1: NUTS 1 - beliebige 3 Ziffern - d. h. FR4 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)

    • nuts2: NUTS 2 - beliebige 4 Ziffern - d. h. FR41 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)

    • nuts3: NUTS 3 - beliebige 5 Ziffern - d. h. FR413 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)

    • city: Code auf Stadtebene - beliebige 7 Ziffern - z. B. DE_DEL1 (Karlsruhe)

Anchor
JSON_DIFF
JSON_DIFF
Unterschiede

...

zwischen JSON Webservice und API Statistics 

Unterschiede in den TIME_PERIOD-Werten

...

Differenztyp

TSV-Dateien im Legacy-Bulk-Download

JSON Webservice


API StatisticsTSV-Dateien in der RENOV-API



Änderung im Daten Zeitraumcode

Muster

Beispiel

Muster

Beispiel

Kommentar

5 Jahre

YYYY

2019

YYYY

2019

Das angegebene Jahr ist das letzte der 5 Jahre.

Jahr

YYYY

2019

YYYY

2019


Semester

YYYYSN

2015S1

YYYY-SN

2015-S1


Quartal

YYYYQN

2015Q4

YYYY-QN

2015-Q4


Monat

YYYYMNN

2015M02

YYYY-MM

2015-02


Woche

YYYYWNN

2020W28

YYYY-WNN

2020-W28


Tag

YYYYMNNDNN

2019M06D13

YYYY-MM-DD

2015-12-31


Unterschiede

...

in die Felder

  • Die Feldreihenfolge:

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

1.version

2.label

3.href

4.source

5.updated

6.status

7.extension

8.class

9.value

10.dimension

11.id

12.size

1.version

2.class

3.label

4.source

5.updated

6.value

7.status

8.id

9.size

10.dimension

11.extension

<<"href" ist in dieser Version nicht vorhanden>>

...

  • “source” Eigenschaftswert

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

Eurostat

ESTAT


  • “updated” Eigenschaftsformat:

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

YYYY-MM-DD

yyyy-MM-ddTHH:mm:ssZ


  • “extension” Feld

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

"datasetId" Eigenschaftsname

“id” Egenschaftsname

Die Eigenschaft "description" ist vorhanden

Die Eigenschaft "description" ist nicht vorhanden

Die Eigenschaft "subTitle" ist vorhanden

Die Eigenschaft "subTitle" wird in den Abschnitt "annotation" verschoben - siehe unten.

“annotiation” ist nicht vorhanden.

"annotation" ist vorhanden und enthält die folgenden zusätzlichen Felder:

DISSEMINATION_OBJECT_TYPE

OBS_COUNT

OBS_PERIOD_OVERALL_OLDEST

OBS_PERIOD_OVERALL_LATEST

UPDATE_STRUCTURE

UPDATE_DATA

SUBTITLE

SOURCE_INSTITUTIONS

DISSEMINATION_PRESENTATIONS

Kombinationen von flags sind nicht vorhanden

Kombinationen von flags sind vorhanden


  • “dimension” Feld

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

Die Dimension "freq" ist nicht vorhanden

Die Dimension "freq" ist vorhanden

Die Eigenschaft "label" enthält den Dimensionscode

Die Eigenschaft "label" enthält den Dimensionstitel


  • “id” Feld

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

"freq" ist nicht vorhanden

"freq" ist vorhanden


  • “size” Feld

Legacy JSON JSON-stat 2.1 WDDS TranslatorWebservice

API Statistics

Das Feld "size" enthält nicht die Dimension "freq"

Das Feld "size" enthält die Dimension "freq"