Document toolboxDocument toolbox

DOI API

Format

doi:10.7303/syn<id>.<version>

 

Where <id> is the entity ID without the "syn" prefix and <version> is the version of the entity.  The version is optional.  Without version, the DOI always points to the most recent version of the entity.

DOI Status

As it takes time to create and register a DOI, we provide a status field in the DOI data object to track updates.  Users can poll the status field for updates.  When a call is first made to create a DOI, the status is IN_PROCESS.  After the DOI is successfully registered, its status changes to READY.  If the creation fails, the status will be updated as ERROR, in which case the client can retry creating the same DOI.

REST APIs

Create

URLHTTP TypeDescription
/entity/<entity_id>/doiPUT

Creates a new DOI for the specified entity.

/entity/<entity_id>/version/<version_number>/doiPUTCreates a new DOI for the specified entity version.

Get

URLHTTP TypeDescription
/entity/<entity_id>/doiGET

Gets the DOI status for the specified entity.

/entity/<entity_id>/version/<version_number>/doiGETGets the DOI status for the specified entity version.