Direkt zum Inhalt
Zum Inhalt springen

Offene Schnittstelle

Für Menschen lesbar. Für Systeme berechenbar.

Alle öffentlichen Antworten sind versioniert, werden als JSON geliefert und sind für lesende, anonyme Nutzung freigegeben. Die API ist bewusst klein und stabil.

In einer Minute loslegen: Daten eintragen, E-Mail bestätigen – der Key wird sofort automatisch zugemailt. Kostenlosen Nutzungs-Key anfordern →

curl -s 'https://datenresonator.de/api/v1/coverage?ids=118540238,4000648-7'

Entität und Links

GET /api/v1/gnd/{GND-ID}/links liefert Identität, Typ, ausgewählte GND-Merkmale und kategorisierte Links. include, exclude, categories und derived filtern die Antwort. Registrierte Websites senden ihren automatisch zugestellten Key im Header X-Datenresonator-Site-Key.

Suche

GET /api/v1/search?q={Suchtext}&type={Typ} sucht über alle GND-Entitätstypen und kann auf einen Typ eingegrenzt werden.

Mengen- und Abdeckungscheck

GET /api/v1/coverage?ids={GND-IDs} prüft bis zu 100 Kennungen gegen alle importierten Quellen und liefert Ergebnisse als JSON oder CSV.

Quellenregister

GET /api/v1/sources veröffentlicht Herkunft, Lizenz, Aktualität und Umfang aller aktiven Datenquellen.

Betriebsstatus

GET /api/v1/status liefert einen maschinenlesbaren Gesundheitsstatus.

OpenAPI

Die formale Beschreibung steht unter /api/v1/openapi.json bereit.

Resolver und SeeAlso

GET /resolve/gnd/{GND-ID} zeigt eine Zielauswahl. /gnd/{GND-ID}/redirect leitet bei genau einem Ziel direkt weiter. Der kompatible Endpunkt /seealso/gnd?id={GND-ID} liefert im Standardformat OpenSearch-Suggestions; format=sources liefert eine einfache Quellenliste.

Standardexporte und gehostete Feeds

Entitätsseiten liefern CSV, JSON-LD, RDF/Turtle und BEACON. Registrierte Quellen erhalten unter /beacon/{quelle}.txt eine normalisierte, CORS-fähige Fassung. /beacon/gesamt.txt und /beacon/kategorie/{bereich}.txt stellen geprüfte importierte Links aggregiert bereit.

Die öffentliche API ist derzeit im dokumentierten Fair-Use-Rahmen kostenlos. Größere Kontingente oder automatisierte Seriennutzung können künftig gesondert buchbar sein; Kosten entstehen nicht automatisch oder rückwirkend.