Identifiers can either be specified in REST API calls, automatically-generated using the internal PID minter, or generated using an external PID minter.
Specifying Identifiers in REST API Calls
If an identifier has already been generated by an application, it can specify the identifier when creating new objects and datastreams using the PUT method in the REST API:
PUT /rest/abc123
Response:
Status: 201 Created Headers: Location: http://localhost:8080/rest/abc123
Internal PID Minter
To have identifiers automatically generated using the internal PID minter, an application can use the POST method in the REST API:
POST /rest
Response:
Status: 201 Created Headers: Location: http://localhost:8080/rest/5b6ff353-b4fc-4b9a-8e36-89f74645327b
External PID Minter
Fedora 4 can also be configured to use an external PID minter via a REST API. When a new object or datastream is created using the POST method, a new identifier will be created using the external PID minter. See Configuring an External PID Minter.
