Der NBN-Resolver auf https://nbn-resolving.org/ bietet eine einfache API, um URNs auflösen oder Informationen über eine URN anzuzeigen.
Achtung
Andere Anfrage-URLs, als die hier aufgelisteten (bspw. solche, die bei Formularanfragen im URN-Resolver verwendet werden), sind nicht stabil und können sich jederzeit ändern. Um eine automatische URN-Auflösung in Anwendungen oder Websites zu integrieren, sind nur die hier aufgelisteten URL-Muster geeignet.
Der Text {PI} ist ein Platzhalter für eine URN (siehe unten).
| Format der Anfrage | Erläuterung |
|---|---|
ohne HTTP-Anfrage-Header | Direkte Weiterleitung zur angefragten Ressource unter Verwendung der ersten funktionierenden URL, die zu dieser Ressource registriert ist. Kann keine funktionierende URL gefunden werden oder dauert die Prüfung zu lange, dann wird zu https://nbn-resolving.org/html/{PI} weitergeleitet (detaillierte Beschreibung des Weiterleitungsalgorithmus) |
mit HTTP-Anfrage-Header:
| Gleiches Verhalten wie bei http://nbn-resolving.org/{PI} ohne HTTP-Anfrage-Header |
mit HTTP-Anfrage-Header:
| Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
mit HTTP-Anfrage-Header:
| Es wird ein pidef-JSON-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
| Anzeige einer Liste der registrierten URLs, die zu dem Persistent Identifier registriert sind |
| Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
| Es wird ein pidef-JSON-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
https://nbn-resolving.org/redirect/{PI} | Direkte Weiterleitung zur angefragten Ressource unter Verwendung der ersten funktionierenden URL, die zu dieser Ressource registriert ist. Kann keine funktionierende URL gefunden werden oder dauert die Prüfung zu lange, dann wird zu https://nbn-resolving.org/html/{PI} weitergeleitet (detaillierte Beschreibung des Weiterleitungsalgorithmus) |
Unterstützte Persistent Identifier
Sonderzeichen in URNs wie der Doppelpunkt oder der Schrägstrich können unkodiert oder Prozent-kodiert angegeben werden.
| Namen | Format | Beispiel | Erläuterung |
|---|---|---|---|
| Deutscher NBN-Namensraum | urn:nbn:de... | urn:nbn:de:1111-20091210269 | |
urn:nbn:de:gbv:7-11858/00-1735-0000-0001-B8C0-F-4 | URN:NBN:DE-URNs mit Schrägstrich | ||
| Deutscher NBN-Namensraum mit Fragmenten | urn:nbn:de.../fragment/... | urn:nbn:de:gbv:089-3321752945/fragment/page=40/highlight=220,620,550,820/zoom=150 | |
| Schweizer NBN-Namensraum | urn:nbn:ch... | urn:nbn:ch:bel-9039 | |
| Österreichischer NBN-Namensraum | urn:nbn:at... | urn:nbn:at:0001-03582 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den österreichischen Resolver weitergegeben |
| Schwedischer NBN-Namensraum | urn:nbn:se... | urn:nbn:se:kb:publ-19 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den schwedischen Resolver weitergegeben |
| Finnischer NBN-Namensraum | urn:nbn:fi... | urn:nbn:fi:tkk-004781 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den finnischen Resolver weitergegeben |
| Niederländischer NBN-Namensraum | urn:nbn:nl... | urn:nbn:nl:ui:12-85062 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den niederländischen Resolver weitergegeben |
| Norwegischer NBN-Namensraum | urn:nbn:no... | urn:nbn:no-3132 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den norwegischen Resolver weitergegeben |
| Tschechischer NBN-Namensraum | urn:nbn:cz... | urn:nbn:cz:aba001-0001qc | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den tschechischen Resolver weitergegeben |
| Ungarischer NBN-Namensraum | urn:nbn:hu... | urn:nbn:hu-3006 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den ungarischen Resolver weitergegeben |
| Italienischer NBN-Namensraum | urn:nbn:it... | urn:nbn:it:unifi-3903 | Kein eigenes Resolving. Die Anfrage wird im Hintergrund an den italienischen Resolver weitergegeben |