/namespaces/name/{name}/urn-suggestion Resource

Returns a suggestion for a new URN in this namespace.

Access: Unauthorized (public) access allowed.

GET /namespaces/name/{name}/urn-suggestion

Returns a suggestion for a new URN in this namespace.

Access: Unauthorized (public) access allowed.

Request Parameters
name type description default constraints
name path namespace for which to return a URN suggestion   required
count query 1 max: 50, min: 1
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
404 if the namespace does not exist (error code 404001)
Response Body
media type data type description
application/json UrnSuggestion (JSON) a suggestion for a URN

Example

Request
GET /namespaces/name/{name}/urn-suggestion
Content-Type: */*
Accept: application/json

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

                
{
  "self" : "http://example.org/namespaces/name/urn:nbn:de:0815/urn-suggestion",
  "suggestedUrns" : [ "urn:nbn:de:0815-200911171195", "urn:nbn:de:0815-200911171195" ],
  "namespace" : "http://example.org/namespaces/name/urn:nbn:de:0815"
}