...
Eine detaillierte Übersicht über alle Befehle der REST-API wird als Teil der REST-API unter docs/index.html angeboten.
Beispiele:
Diese Seite zeigt Beispiele für typische Aktivitäten bei der Verwaltung von URNs über die REST-API.
...
Besteht Interesse, die eigene (Java-)Anwendung an die URN-Rest-API anzubinden, um beispielsweise auf diesen Weg regelmäßig neue URNs zu registrieren oder zu aktualisieren, bietet die Deutsche Nationalbibliothek einen Java-Client an, um die bestehende URN-REST-API anzusprechen. Dieser Client sollte den eigenen Programmieraufwand deutlich reduzieren.Das Verwenden der URN-REST-API Der Client dient zur Reduzierung des eigenen Programmieraufwandes und stellt eine modernere Alternative dar zu den bisherigen Möglichkeiten dar .
Technische Voraussetzungen:
- Die Verwendung von Java 8 oder kompatiblere JVM Sprache in der entsprechenden Version.
- Berechtigung zur Einspielung von URNS der eigenen Institutionen innerhalb des eigenen Namensraumes in Form von LOGIN / USER Credentials.
Eine BeispielmethodeUmfangreiche Beispielmethoden, um eigene URNs über den REST-Client in das mit dem URN-System einzuspielen finden Sie in UrnRestApiExporter Klasse unter ./example Unterordner.
zu interagieren finden sie hier: Nutzungsbeispiele Java-Client .
Für die Nutzung des Java-Clients und möglich Folge daraus übernimmt die Deutsche Nationalbibliothek keine Verantwortung. Die eigenen Implementierung sind daher vor der produktiven Nutzung ausreichend zu testen. Hierzu kann die Sandbox Umgebung der URN-Service unter http://api.nbn-resolving.org/sandbox/v2/ genutzt werden.
Fehler oder Verbesserungshinweise können an die Service Adresse (urn-support@dnb.de) des URN-Service gemeldet werden. Zeitpunkt und Umfang der Anpassungen/ Fehlerbehebungen können jedoch nicht garantiert werden. URN-Release finde in der Regel dreimal pro Jahr statt, in denen bei freien Kapazitäten auch der Java-Client bearbeitet wird. Neu Versionen des Client werden an dieser Stelle angekündigt.
(Stand: 18. Dezember 2023)