/gnd/search?q=text
/gnd/<id>.json
Standardmäßig liefert dieser Dienst strukturierte API-Antworten (als JSON):
curl https://lobid.org/gnd/4074335-4
Er unterstützt Content-Negotiation über den Accept-Header für JSON (application/json) und HTML (text/html):
curl --header "Accept: application/json" https://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" "https://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" "https://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. https://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 https://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" https://lobid.org/gnd/4074335-4
curl --header "Accept: text/turtle" https://lobid.org/gnd/4074335-4
curl --header "Accept: application/n-triples" https://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:
https://lobid.org/gnd/reconcile/
(diese URL in OpenRefine verwenden).
Wir beteiligen uns an der Standardisierung dieser Schnittstellen im Rahmen der W3C Reconciliation Community Group. Die im Rahmen dieser Gruppe entwickelte reconciliation service test bench gibt einen Überblick über die von lobid-gnd unterstützten Reconciliation APIs und bietet die Möglichkeit zur direkten Interaktion mit diesen APIs.
CORS header
curl --head https://lobid.org/gnd/reconcile/ | grep Access-Control-Allow-Origin
Query: POST
curl --data 'queries={"q1":{"query":"Twain, Mark"}}' https://lobid.org/gnd/reconcile/
Extend: POST
curl --data 'extend={"ids":["1081942517","4791358-7"],"properties":[{"id":"preferredName"},{"id":"firstAuthor"}]}' https://lobid.org/gnd/reconcile/