Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Der NBN-Resolver auf https://nbn-resolving.org/ bietet eine einfache API, um URNs auflösen oder Informationen über eine URN anzuzeigen.

Info
titleAchtung
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 AnfrageErläuterung

https://nbn-resolving.org/{PI}

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 eine Liste der registrierten URLs für den Persistent Identifier angezeigt.zu https://nbn-resolving.org/html/{PI} weitergeleitet (detaillierte Beschreibung des Weiterleitungsalgorithmus)

https://nbn-resolving.org/{PI}

mit HTTP-Anfrage-Header:

  • Accept: text/html
  • Accept: application/xhtml+xml 
Gleiches Verhalten wie bei http://nbn-resolving.org/{PI} ohne HTTP-Anfrage-Header

https://nbn-resolving.org/{PI}

mit HTTP-Anfrage-Header:

  • Accept: text/xml
  • Accept: application/xml
Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs

https://nbn-resolving.org/{PI}

mit HTTP-Anfrage-Header:

  • Accept: application/json
Es wird ein pidef-JSON-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs

https://nbn-resolving.org/html/{PI}

Anzeige einer Liste der registrierten URLs, die zu dem Persistent Identifier registriert sind

https://nbn-resolving.org/xml/{PI}

Es wird ein pidef-XML-Dokument zurückgeliefert mit Informationen zur URN und den registrierten URLs

https://nbn-resolving.org/json/{PI}

 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)

Anker
supported-pis
supported-pis
Unterstützte Persistent Identifier

...