| Table of Contents |
|---|
Der DissChain WDDS Translator ist API Statistics ist ein Webdienst , der einen älteren WDDS 2.1-REST in eine Anforderung übersetzt, die an die RENOV-API gesendet wird, wobei die Reihenfolge der Parameter unabhängig ist. Dies bedeutet, dass diese für Datenabfrage, dass die Parameter keine bestimmte Reihenfolge einhalten müssen.Die RENOV-API gibt eine Datei als Anhang (Daten und Metadaten aus einem einzelnen Datensatz) im JSON-Stat 2.0-Format an den WDDS Translator zurück. Letzterer gibt den Inhalt der Datei als JSON-Antwort ohne Inhaltstransformation an den Anforderer zurück.
Der Webdienst:
stellt Daten im JSON-stat 2.0-Format bereit;
unterstützt nur das REST-Protokoll (Representation State Transfer);
liefert Antworten in englischer, französischer und deutscher Sprache.
...
WDDS Translator ersetzt den alten WDDS 2.1-Webdienst und ermöglicht einen reibungslosen Übergang der Estat.B4-Visualisierungsanwendungen.
...
oder deutscher Sprache.
Die Struktur der REST-Anfrage
...
URL-Teil | Beispiel | Kommentar |
|---|---|---|
Fester Teil (fixed part) | ||
{host_url}/ | https://ec.europa.eu/eurostat/api/dissemination/ https://ec.europa.eu/eurostat/api/comext/dissemination (Comext und Prodcom Datensätze) | Fester Teil der Anfrage im Zusammenhang mit unserer Website |
{service}/ | statistics/ | Fester Teil der Anfrage im Zusammenhang mit dem Service |
{version}/ | 1.0/ | Fester Teil der Anfrage im Zusammenhang mit der Version des Services |
Dynamischer Teil (dynamic part) | ||
{response_type}/ | data/ | Derzeit werden nur statistische Daten zurückgegeben |
{datasetCode} | t2020nama_10_gdp | Eindeutige Code-ID des abgefragten Datenprodukts (entweder ein Datensatz oder eine vordefinierte Extraktion) |
?{format} | ?format=JSON | Optionaler Parameter |
&{lang} | &lang=DE | Optionaler Parameter |
&{filters} | &time=2019 | Optionaler Parameter |
...
Fehlercode | HTTP-Status | Beschreibung | |||
|---|---|---|---|---|---|
Client-Fehler | |||||
100 Kein Ergebnis gefunden | 400 Ungültige Anfrage | Das Ergebnis der Abfrage ist leer. | |||
100 Kein Ergebnis gefunden | 404 Nicht gefunden | Die angeforderte Ressource ist nicht verfügbar. | 110 Nicht autorisiert | 401 Nicht autorisiert | Zur Verwendung, wenn eine Authentifizierung erforderlich ist, diese jedoch fehlgeschlagen ist oder noch nicht bereitgestellt wurde . ECAS-Fehler können sein: INVALID_ECAS_CONFIGURATION INVALID_STRENGTH INVALID_PROXY USER_NOT_AUTHORIZED FAILED_TICKET_VALIDATION UNEXPECTED_LOGIN INVALID_LOGIN_DATE ECAS client/handler exceptions |
140 Syntax-Fehler | 400 Ungültige Anfrage | Die Abfrage ist ungültig. | 140 Syntax-Fehler | 404 Nicht gefunden | Die angeforderte Ressource ist nicht Teil der unterstützten Methoden . Nicht unterstützte Ressourcen: agencyscheme attachmentconstraint dataschema dataproviderscheme dataconsumerscheme genericmetadata generictimeseriesdata hierarchicalcodelist metadata metadataflow metadataschema metadatastructure organisationunitscheme organisationscheme process provisionagreement reportingtaxonomy structures structurespecificmetadata structurespecifictimeseriesdata |
150 Semantischer Fehler | 400 Ungültige Anfrage | Die Anforderung ist syntaktisch korrekt, schlägt jedoch einer semantische Validierung und Validierung gegen Geschäftsregeln fehl. | |||
Serverfehler | |||||
500 Interner Serverfehler401 Nicht autorisiert | Die angeforderte Ressource ist vorhanden, aber derzeit nicht verfügbar. | 500 Interner Serverfehler | 500 Interner Serverfehler | Der Webservice sollte diesen Fehlercode zurückgeben, wenn keiner der anderen Fehlercodes den Grund für das Versagen des Dienstes, eine aussagekräftige Antwort zu liefern, besser beschreibt. Wird auch verwendet, wenn die Anforderung die xsd-Definition nicht berücksichtigt. |
...
Beim Empfang einer Anforderung vom WDDS Translator kann die API bestimmen, ob die Antwort synchron oder asynchron erfolgen kann.
Im Falle einer asynchronen Antwort gibt der WDDS Translator die API die folgende JSON-Antwort zurück:
| Code Block |
|---|
{"warning":{"status":413, "label":"ASYNCHRONOUS_RESPONSE. Your request will be treated asynchronously. Please try again later."}} |
| Info |
|---|
WDDS API Statistics benachrichtigt den Benutzer nicht, wenn die Datei fertig ist. Die Anforderung muss erneut gestellt werden, um den Status zu überprüfen. |