Page tree

Old Release

This documentation covers an old version of Fedora. Looking for another version? See all documentation.

Skip to end of metadata
Go to start of metadata

Overview


Identifiers can be specified in REST API calls and generated either automatically using the internal PID minter or via an external REST service.

Specifying Identifiers in REST API Calls

If an identifier has already been generated by an application, you can specify it when creating resources using the PUT method:

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:

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 retrieve identifiers from an external HTTP minter service.  When a new object or datastream is created using the POST method, an identifier will be created using the external PID minter.  See Configuring an External PID Minter.

Custom PID Minters

To use a different identifier generation process, you can create a custom PID minter implementation, which can be configured in the same way as the external PID minter.  If your identifiers are generated from an HTTP service, then you should consider extending (or improving) HttpPidMinter.java to meet your needs.  Implementing UniqueValueSupplier.java is another option.