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 |
Veraltete Anfrage-Formate
Der URN-Resolver unterstützt eine Reihe veralteter Anfrageformate, um die Kompatibilität mit den alten Resolvern zu gewährleisten. Diese sollten in neuen Anwendungen nicht mehr verwendet werden und in existierenden Anwendungen nach Möglichkeit durch Anfragen nach dem oben beschriebenen Format ersetzt werden. Es ist beabsichtigt, die Unterstützung für veraltete Abfrage zu einem späteren Zeitpunkt aus dem NBN-Resolver zu entfernen.
Format der Anfrage | Erläuterung |
---|---|
/urn/urn_aufloesung_redirect.pl?{PI} | Veraltet, nicht mehr verwenden |
/urn/urn_aufloesung_redirect.pl?nss={PI} | Veraltet, nicht mehr verwenden |
/urn/resolver.pl?{PI} | Veraltet, nicht mehr verwenden |
/urn/resolver.pl?urn={PI} | Veraltet, nicht mehr verwenden |
/urn/resolver.pl?urn={PI}&xml | Veraltet, nicht mehr verwenden |
/urn/resolver.pl?urn={PI}&xml=on | Veraltet, nicht mehr verwenden |
/urn/resolver.pl?urn={PI}&xml=True | Veraltet, nicht mehr verwenden |
/resolver?identifier={PI} | Veraltet, nicht mehr verwenden |
/resolver?identifier={PI}&verb=redirect | Veraltet, nicht mehr verwenden |
/resolver?identifier={PI}&xml | Veraltet, nicht mehr verwenden |
/resolver?identifier={PI}&xml=on | Veraltet, nicht mehr verwenden |
/resolver?identifier={PI}&xml=True | Veraltet, nicht mehr verwenden |
/urn={PI} | Veraltet, nicht mehr verwenden |
/?{PI} | Veraltet, nicht mehr verwenden |
/?urn={PI} | Veraltet, nicht mehr verwenden |
Unterstützte Persistent Identifier
In den URNs können Sondernzeichen wie Doppelpunkt oder der Schrägstrich Prozent-kodiert 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 | Alte 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 | |
DOI | doi:10.... | doi:10.1000/182 | |
The Handle-System | hdl:... | hdl:4263537/4086 | |
Archival Resource Key | ark:... | ark:/13030/tf5p30086k | |
ArXiv | arXiv:... | arXiv:1103.5321 | |
Deutscher NBN-Namensraum (veraltet) | nbn:de... | nbn:de:kobv:11-10028937 | Veraltetes Format, nicht mehr verwenden |
Schweizer NBN-Namensraum (veraltet) | nbn:ch... | nbn:ch:bel-9039 | Veraltetes Format, nicht mehr verwenden |
Österreichischer NBN-Namensraum (veraltet) | nbn:at... | nbn:at:0001-03582 | Veraltetes Format, nicht mehr verwenden |
DOI (veraltet) | 10.... | 10.1000/182 | Veraltetes Format, nicht mehr verwenden |