Technische Nutzung der Codelisten-Registry

Die in der Codelisten-Registry verfügbaren Codelisten-Register, Codelisten und Codes werden üblicherweise über die Weboberfläche der Registry mit einem Internet-Browser abgerufen. Auf dieser Wiki-Seite wird anhand von cURL beispielhaft beschrieben, wie die Inhalte der Registry mit anderer Software abgerufen werden können. Dabei kommt das REST Paradigma zum Einsatz.

Die Codelisten-Registry stellt ihre Inhalte in verschiedenen Formaten zum Download bereit. Für die Visualisierung der Inhalte über die Weboberfläche werden die Dateien im JSON Format herangezogen. Wenn die in der Weboberfläche dargestellten Informationen von anderer Software abgerufen und verarbeitet werden sollen, empfiehlt es sich daher ebenfalls auf die JSON-Dateien zurückzugreifen. Die anderen Formate können allerdings ebenfalls für die Weiterverarbeitung geparst werden, da sie im Prinzip die selben Informationen enthalten. Die meisten der folgenden Beispiele verwenden das JSON Format.

Eine Codeliste abrufen

curl -H "Accept: application/json" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

Detailinformationen zu einem Code abrufen

curl -H "Accept: application/json" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue/8_AussenbereichsSatzung

Ein bestimmtes Dateiformat abrufen

curl -H "Accept: application/xml" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

curl -H "Accept: application/x-iso19135+xml" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

curl -H "Accept: application/atom+xml" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

curl -H "Accept: text/csv" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

curl -H "Accept: application/rdf+xml" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue

Dateien in einer bestimmten Sprache abrufen (Deutsch oder Englisch)

Wird kein Header für die Sprache angegeben, dann wird die englische Version der Datei als Standard zurückgegeben.

curl -H "Accept: application/json" -H "Accept-Language: de" https://registry.gdi-de.org/codelist/de.xleitstelle.inspire_plu/PlanTypeNameValue