Der NBN-Resolver auf https://nbn-resolving.org/ bietet eine einfache API, um URNs auflösen oder Informationen über eine URN anzuzeigen.
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 oder einen anderen unterstützen Persistent Identifier (siehe unten)
| Format der Anfrage | Erläuterung |
|---|---|
ohne HTTP-Anfrage-Header | Direkte Weiterleitung zur angefragten Ressource unter Verwendung der ersten funktioniernden URL, die zu dieser Ressource funktioniert ist. Kann keine funktionierende URL gefunden werden oder dauert die Prüfung zu lange, dann wird eine Liste der registrierten URLs für den Persistent Identifier angezeigt. |
mit dem HTTP-Anfrage-Header
oder
| Gleiches Verhalten wie bei http://nbn-resolving.org/{PI} ohne HTTP-Anfrage-Header |
mit dem HTTP-Anfrage-Header
oder
| Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
mit dem HTTP-Anfrage-Header
| Es wird ein pidef-JSON-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
http://nbn-resolving.org/html/{PI} | Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
http://nbn-resolving.org/xml/{PI} | |
http://nbn-resolving.org/json/{PI} | Es wird ein pidef-JSON-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs |
http://nbn-resolving.org/redirect/{PI} | Direkte Weiterleitung zur angefragten Ressource unter Verwendung der ersten funktioniernden URL, die zu dieser Ressource funktioniert ist. Kann keine funktionierende URL gefunden werden oder dauert die Prüfung zu lange, dann wird zu http://nbn-resolving.org/html/{PI} weitergeleitet |
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 | |
| Schwedischer NBN-Namensraum | urn:nbn:se... | urn:nbn:se:kb:publ-19 | |
| Finnischer NBN-Namensraum | urn:nbn:fi... | urn:nbn:fi:tkk-004781 | |
| Niederländischer NBN-Namensraum | urn:nbn:nl... | urn:nbn:nl:ui:12-85062 | |
| Norwegischer NBN-Namensraum | urn:nbn:no... | urn:nbn:no-3132 | |
| Tschechischer NBN-Namensraum | urn:nbn:cz... | urn:nbn:cz:aba001-0001qc | |
| Ungarischer NBN-Namensraum | urn:nbn:hu... | urn:nbn:hu-3006 | |
| Italienischer NBN-Namensraum | urn:nbn:it... | urn:nbn:it:unifi-3903 |