Resources

path methods description
  • GET
Returns basic information about the URN REST-API.

Access: Unauthorized (public) access allowed.

  • /admins
  • GET POST
Administrative Accounts for system administrators.
  • /admins/login/{login}
  • DELETE GET PATCH
Administrative Accounts for system administrators.
  • /namespaces
  • GET POST
Namespaces that are managed by the URN-Service.
  • /namespaces/name/{name}
  • DELETE GET HEAD PATCH
Namespaces that are managed by the URN-Service.
  • /namespaces/name/{name}/urn-suggestion
  • GET
Returns a suggestion for a new URN in this namespace.

Access: Namespace owners only for their own namespaces.

  • /namespaces/name/{name}/urns
  • GET
Returns all registered URNs in a namespace. The result set can be filtered using the q parameter.

The result set is paged. The count and offset parameters can be used to navigate through the result list. Alternatively, the Link header contains URLs for browsing through the result list.

Access: Unauthorized (public) access allowed.

  • /namespaces/suggestion
  • GET
Returns a suggestion for a new namespace name.

Access: System administrators only.

  • /organisations
  • GET POST
Organisations and contacts who manage their URNs and URLs with the URN-Service.
  • /organisations/id/{id}
  • DELETE GET PATCH
Organisations and contacts who manage their URNs and URLs with the URN-Service.
  • /organisations/id/{id}/contacts
  • GET POST
Organisations and contacts who manage their URNs and URLs with the URN-Service.
  • /organisations/id/{id}/contacts/id/{contactId}
  • DELETE GET PATCH
Organisations and contacts who manage their URNs and URLs with the URN-Service.
  • /organisations/id/{id}/namespaces
  • GET
Returns the namespaces of an organisation.

Access: Unauthorized (public) access allowed.

  • /organisations/login/{login}
  • GET
Returns an organisation by its login name.

Access: Unauthorized (public) access allowed.

  • /policies/url
  • GET
Returns a list of all supported URL policies.

Access: Unauthorized (public) access allowed.

  • /policies/url/id/{id}
  • GET
Returns a URL policy by its id.

Access: Unauthorized (public) access allowed.

  • /policies/urn-naming
  • GET
Returns a list of all supported URN naming policies.

Access: Unauthorized (public) access allowed.

  • /policies/urn-naming/id/{id}
  • GET
Returns a URN naming policy by its id.

Access: Unauthorized (public) access allowed.

  • /urns
  • GET POST
URNs managed by the URN-Service.
  • /urns/urn/{urn}
  • DELETE GET HEAD PATCH
URNs managed by the URN-Service.
  • /urns/urn/{urn}/my-urls
  • GET PATCH
URNs managed by the URN-Service.
  • /urns/urn/{urn}/urls
  • GET POST
URNs managed by the URN-Service.
  • /urns/urn/{urn}/urls/base64/{url}
  • DELETE GET
URNs managed by the URN-Service.