= PID API =

A webservice for generating a PID is provided.

The API is trivially simple: A call to the given method will give the next available API. Optionally, a string may be given that should be part of the PID.

The call should never fail.

Implementation note: Due to a length restriction of 64 characters for Fedora PIDs, any string longer than approx 50 characters will be shortened, to ensure space for adding a unique part to the PID.


== PID API ==

WSDL: [[attachment:DomsPIDGenerator.xml]]

The following describes those methods of the PID API that may be called by the GUI.

==== generateNexAvailablePID ====
Generates a new PID.

Input parameters:
 * {{{String infix}}} The PID of the object.

Returns:
 * {{{String}}} The newly generated unique PID, possibly including the provided infix.