Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


Excerpt

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:

Code Block
PUT /rest/abc123

Response:

 

Code Block
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:

Code Block
POST /rest

Response:

Code Block
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.

...