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

Returns a suggestion for a new URN in this namespace.

Access: Namespace owners only for their own namespaces.

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

Returns a suggestion for a new URN in this namespace.

Access: Namespace owners only for their own namespaces.

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
401 if the user is not authenticated (error code 401001)
403 if the user is not authorized to get suggestions for URNs in this namespace (403001)
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"
}