/urns/urn/{urn}/urls/base64/{url} Resource

URNs managed by the URN-Service.

GET /urns/urn/{urn}/urls/base64/{url}

Returns the registration information for a URL.

Access: Unauthorized (public) access allowed.

Request Parameters
name type description constraints
url path of the URL whose registration information should be returned. The URL must be base64 encoded required
urn path whose URLs are queried required
runas query optional login name whose identity is used to execute the request (only available to users with the RunAs privilege)  
Response Codes
code condition
200 if the request was completed successfully
401 if the user is not authenticated (error code 401001)
404 if no URL could be found for id (error code 404001)
Response Body
media type data type description
application/json Url (JSON) the registration information of the URL

Example

Request
GET /urns/urn/{urn}/urls/base64/{url}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "self" : "http://example.org/urns/urn/urn:nbn:de:101:1-200911171195/urls/base64/aHR0cDovL2V4YW1wbGUub3JnL3RoZS1kb2N1bWVudC5wZGY=",
  "created" : "2017-03-02T15:23:16.123Z",
  "lastModified" : "2017-03-02T15:23:16.123Z",
  "url" : "http://example.org/the-document.pdf",
  "urn" : "http://example.org/urns/urn/urn:nbn:de:101:1-200911171195",
  "owner" : "http://example.org/organisations/id/1516",
  "priority" : 100
}

DELETE /urns/urn/{urn}/urls/base64/{url}

Deletes a URL registration.

A URL can only be deleted if it is not the last URL registered for this URN.

Access: Logged in organisations only for their own URLs.

Request Parameters
name type description constraints
url path of the URL which should be deleted. The URL must be base64 encoded required
urn path whose URLs are queried required
runas query optional login name whose identity is used to execute the request (only available to users with the RunAs privilege)  
Response Codes
code condition
204 if the URL registration was deleted successfully
401 if the user is not authenticated (error code 401001)
403 if the user is not authorized to delete
  • this URL (error code 403001) or
  • the last URL attached to a URN (error code 403001).
404 if the URL is not registered (error code 404001)

Example

Request
DELETE /urns/urn/{urn}/urls/base64/{url}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content