/gnd/search?q=text
/gnd/<id>.json
Standardmäßig liefert dieser Dienst strukturierte API-Antworten (als JSON):
curl http://lobid.org/gnd/4074335-4
Er unterstützt Content-Negotiation über den Accept-Header für JSON (application/json), JSON lines (application/x-jsonlines) oder HTML (text/html):
curl --header "Accept: application/json" http://lobid.org/gnd/search?q=london
Der Query-Parameter "format" (Werte: html,json,jsonl) kann verwendet werden, um den Accept-Header aufzuheben, z.B. zur Anzeige von JSON im Browser:
Der Wert des Format-Parameters kann für Einzeltreffer auch in URLs als Dateiendung verwendet werden:
Einzeltreffer unterstützen zudem verschiedene RDF-Serialisierungen (siehe Abschnitt zu JSON-LD).
Bulk-Downloads können im Format JSON lines (Accept: application/x-jsonlines oder format=jsonl) bezogen werden:
curl --header "Accept: application/x-jsonlines" "http://lobid.org/gnd/search?q=type:Country" > countries.jsonl
Für größere Anfragen kann die Antwort als gzip komprimiert werden:
curl --header "Accept-Encoding: gzip" "http://lobid.org/gnd/search?q=type:Company&format=jsonl" > companies.gz
Siehe auch diesen Abschnitt zu Bulk-Downloads in unserem Blog.
Die API unterstützt ein spezielles Antwortformat mit Vorschlägen zur Autovervollständigung.
Damit kann z.B. eine Autovervollständigung umgesetzt werden, bei der zur Suche an Stelle des gewählten Labels die entsprechende ID verwendet werden kann:
Dieses Beispiel ist folgendermaßen mit JavaScript und jQuery UI implementiert:
$('input.search-gnd').autocomplete({ source : function(request, response) { $.ajax({ // use full URL in your code, i.e. http://lobid.org/gnd/search url : "/gnd/search", dataType : "jsonp", data : { q : request.term, format : "json:preferredName,professionOrOccupation" }, success : function(data) { response(data); } }); }, select: function(event, ui) { $('#id').val('id:"'+ui.item.id+'"'); } });
JSON-API-Anfragen liefern JSON-LD. Um damit zu experimentieren können sie das JSON-LD oder URLs im JSON-LD Playground einfügen.
jsonld format --nquads http://lobid.org/gnd/4074335-4
Einzeltreffer können per Accept
Header auch direkt als RDF/XML, Turtle oder N-Triples angefordert werden:
curl --header "Accept: application/rdf+xml" http://lobid.org/gnd/4074335-4
curl --header "Accept: text/turtle" http://lobid.org/gnd/4074335-4
curl --header "Accept: application/n-triples" http://lobid.org/gnd/4074335-4
Dabei werden wie im Abschnitt zu Inhaltstypen beschrieben neben dem Format-Parameter auch URLs mit Formatendungen unterstützt:
Dieser Dienst bietet eine Implementierung der OpenRefine Reconciliation API an.
Intern sendet OpenRefine folgende Art von Anfrage:
curl --data 'queries={"q1":{"query":"Twain, Mark"}}' http://lobid.org/gnd/reconcile
Tutorial
Eine Anleitung zur Verwendung der GND Reconciliation in OpenRefine findet sich in unserem Blog.