...
Nachfolger einer URN setzen
...
In seltenen Fällen kann es vorkommen, dass eine URN durch eine Nachfolge-URN ersetzt werden soll. Beim Resolving soll dann automatisch von der alten URN zum Nachfolger weitergeleitet werden. URN-Besitzer können diese Nachfolger-Beziehung einrichten. Dies geschieht über einen PATCH-Request auf due URN-Ressource /urns/urn/<urn>. Die Nachfolger-URN wird über ihren kanonischen API-Referenz identifiziert, der im @id-Feld jeder URN enthalten ist:
| Codeblock |
|---|
PATCH /sandbox/v2/urns/urn/urn:nbn:de:example-2019021315155244513532
Authorization: Basic dXJuLXBhcnRuZXI6bWVpbi1wYXNzd29ydA==
Content-Type: application/json
Accept: application/json
{
"successor": "http://localhost:8080/sandbox/v2/urns/urn/urn:nbn:de:example-20190213151552346346245"
} |
| Codeblock | ||||
|---|---|---|---|---|
| ||||
HTTP/1.1 204 No Content
Date: Wed, 13 Feb 2019 15:40:34 GMT
<Response body is empty> |
Das erfolgreiche Setzen der Nachfolge-URN wird mit dem Status 204 No Content quittiert.
Nachfolger einer URN entfernen
Falls ein Nachfolge-URN fälscherlicher Weise gesetzt wurde, kann sie einfach wieder entfernt werden, indem ein PATCH-Request mit einem null-Wert als Nachfolger gesendet wird:
| Codeblock |
|---|
PATCH /sandbox/v2/urns/urn/urn:nbn:de:example-2019021315155244513532
Authorization: Basic dXJuLXBhcnRuZXI6bWVpbi1wYXNzd29ydA==
Content-Type: application/json
Accept: application/json
{
"successor": null
} |
| Codeblock | ||||
|---|---|---|---|---|
| ||||
HTTP/1.1 204 No Content
Date: Wed, 13 Feb 2019 15:43:28 GMT
<Response body is empty> |
Das erfolgreiche Löschen der Nachfolge-URN wird mit dem Status 204 No Content bestätigt.