Daten per API und Link nachnutzen¶
Alle Daten im Portal lassen sich ohne Anmeldung und ohne Zugangsschlüssel abrufen. Die Lizenz steht bei jedem Datensatz in der Übersicht und unter Metadaten.
Fertige Beispiele auf jeder Datensatzseite¶
Der Bereich API-Beispielabfrage zeigt für genau diesen Datensatz die vollständige Adresse und Code zum Kopieren – in cURL, Python, R, JavaScript, Java und Bash. Im Browser testen öffnet die Abfrage direkt.
Die API ist unter https://odw.odi.schleswig-holstein.de/api erreichbar. <id> steht im Folgenden für die Kennung des Datensatzes – der letzte Teil der Adresse der Datensatzseite.
Inhalt der Datentabelle abrufen¶
| Parameter | Bedeutung | Standard |
|---|---|---|
page |
Seite | 1 |
limit |
Zeilen pro Seite | 50 |
q |
Suche über alle Spalten | – |
curl "https://odw.odi.schleswig-holstein.de/api/datasets/open-data-portal-zugriffszahlen-v2/content?page=1&limit=5"
Die Antwort ist JSON: die Zeilen unter data, dazu total, page und limit.
Die Abfrage gibt es für Datensätze mit Datentabelle. Bei Geodaten mit WFS-Dienst zeigt der Bereich stattdessen den Zugriff auf den Dienst, mit Link auf die Capabilities und Auswahl des Objekttyps.
Dateien direkt herunterladen¶
Unter Dateien hat jede Datei eine feste Adresse. Der Block Direkter Download in der API-Beispielabfrage zeigt, wie Sie die Dateien per Code laden – nützlich, wenn eine Auswertung regelmäßig läuft.
Metadaten maschinenlesbar¶
<format> ist rdf (RDF/XML), ttl (Turtle), n3 oder jsonld. Mit ?download=1 kommt die Antwort als Datei. Die Angaben folgen DCAT-AP.de.
Immer die neueste Ausgabe einer Serie¶
Bei Datensatzserien hat jede neue Ausgabe eine eigene Kennung. Für wiederkehrende Auswertungen gibt es deshalb feste Adressen an der Serie:
| Adresse | Liefert |
|---|---|
/api/datasetseries/<id> |
die Serie mit allen Ausgaben (JSON-LD) |
/api/datasetseries/<id>/latest/content |
die Datentabelle der neuesten Ausgabe |
/api/datasetseries/<id>/latest.jsonld |
die Metadaten der neuesten Ausgabe |
Die vollständigen Adressen und Code-Beispiele stehen auf der Serienseite unter API-Beispielabfrage.
Auf Seiten im Portal verlinken¶
Die Adressen im Portal sind dafür gemacht, weitergegeben zu werden. Sie beginnen mit https://opendata.schleswig-holstein.de/v2.
| Ziel | Adresse |
|---|---|
| Datensatz | /dataset/<id> |
| bestimmter Bereich eines Datensatzes | /dataset/<id>?tab=datatable |
| Datentabelle mit Suchbegriff | /dataset/<id>?tab=datatable&table-filter=<Begriff> |
| bestimmte Zusammenfassung | /dataset/<id>?tab=reports&bericht=<kennung> |
| Datensatzserie | /datasetseries/<id> |
| Herausgeber | /publisher/<id> |
| Suche mit Filtern | /search?q=<Begriff>&publishers=<id>&formats=csv |
Für tab sind diese Werte möglich: overview, reports, map, datatable, related, data, api, metadata, dcat, history. Am einfachsten kopieren Sie die Adresse aus dem Browser, nachdem Sie den gewünschten Bereich geöffnet haben.
Wer mehr braucht¶
Abfragen über den gesamten Katalog, etwa alle Datensätze eines Herausgebers als Liste, beantwortet der Datenkatalog selbst. Den Einstieg dazu geben die API Referenz und die Seite Semantic Data & SPARQL der ODI.