{"openapi":"3.1.0","info":{"title":"datenresonator API","version":"1.2.0","description":"\u00d6ffentliche Leseschnittstelle f\u00fcr GND-Entit\u00e4ten und kuratierte Verkn\u00fcpfungen sowie optionale, datensparsame Wirkungsz\u00e4hlung."},"servers":[{"url":"https:\/\/datenresonator.de"}],"paths":{"\/api\/v1\/gnd\/{gnd}\/links":{"get":{"summary":"Entit\u00e4t und Links abrufen","parameters":[{"name":"gnd","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Datenresonator-Site-Key","in":"header","required":false,"description":"Domaingebundener Key aus der kostenlosen Self-Service-Registrierung.","schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}},{"name":"include","in":"query","required":false,"description":"Kommagetrennte Quellen-IDs, die enthalten sein sollen.","schema":{"type":"string"}},{"name":"exclude","in":"query","required":false,"description":"Kommagetrennte Quellen-IDs, die ausgeschlossen werden sollen.","schema":{"type":"string"}},{"name":"categories","in":"query","required":false,"description":"Kategorien, getrennt durch Komma, Semikolon oder senkrechten Strich.","schema":{"type":"string"}},{"name":"derived","in":"query","required":false,"description":"Aus Wikidata abgeleitete Links ein- oder ausschlie\u00dfen.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Erfolgreiche Antwort"},"403":{"description":"Site-Key fehlt oder passt nicht zur anfragenden Website"},"429":{"description":"Anfragelimit \u00fcberschritten"}}}},"\/seealso\/gnd":{"get":{"summary":"SeeAlso-kompatible Ziele oder Quellen abrufen","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["seealso","sources","redirect"],"default":"seealso"}}],"responses":{"200":{"description":"OpenSearch-Suggestions oder Quellenliste"},"400":{"description":"Ung\u00fcltige Kennung"}}}},"\/api\/v1\/search":{"get":{"summary":"GND durchsuchen","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["Person","Family","CorporateBody","PlaceOrGeographicName","SubjectHeading","Work","ConferenceOrEvent"]}}],"responses":{"200":{"description":"Suchergebnisse"},"400":{"description":"Ung\u00fcltige Suchanfrage"},"429":{"description":"Anfragelimit \u00fcberschritten"}}}},"\/api\/v1\/status":{"get":{"summary":"Systemstatus abrufen","responses":{"200":{"description":"Statusantwort"}}}},"\/api\/v1\/sources":{"get":{"summary":"Quellen, Lizenz- und Aktualit\u00e4tsangaben abrufen","responses":{"200":{"description":"\u00d6ffentliches Quellenregister"}}}},"\/api\/v1\/sources\/{source}\/versions":{"get":{"summary":"Versionen und Inhaltsfingerabdr\u00fccke einer Quelle abrufen","parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\u00d6ffentliche Importhistorie"},"404":{"description":"Quelle nicht gefunden"}}}},"\/api\/v1\/coverage":{"get":{"summary":"Abdeckung einer Liste von bis zu 100 GND-IDs pr\u00fcfen","parameters":[{"name":"ids","in":"query","required":true,"description":"GND-IDs, durch Komma, Leerraum oder Semikolon getrennt.","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Abdeckungsbericht als JSON oder CSV"},"400":{"description":"Ung\u00fcltige oder zu umfangreiche Eingabe"},"429":{"description":"Anfragelimit \u00fcberschritten"}}}},"\/api\/v1\/events":{"post":{"summary":"Optionales anonymes Widget-Ereignis als Tagesaggregat z\u00e4hlen","description":"Akzeptiert nur registrierte site_key-\/Origin-Paare. Es werden weder GND-ID noch Ziel-URL, IP-Adresse, Cookie oder User-Agent in der Wirkungsstatistik gespeichert.","requestBody":{"required":true,"content":{"text\/plain":{"schema":{"type":"object","required":["site_key","event"],"properties":{"site_key":{"type":"string"},"event":{"type":"string","enum":["widget_load","outbound_click"]},"surface":{"type":"string"}}}}}},"responses":{"204":{"description":"Tagesz\u00e4hler aktualisiert"},"403":{"description":"Messstelle oder Origin nicht akzeptiert"},"429":{"description":"Anfragelimit \u00fcberschritten"}}}}}}