DOxI Documentation

a short introduction into the MPDL DOI service called DOxI

REST API

Function	HTTP method	Path	Body	URL Parameter	Success return value
Create DOI	PUT	/doi/{doi}	Metadata in XML format. DOI in XML will be replaced.	url (required): Target URL for this DOI	HTTP Status: 201 - CREATED Body: created DOI in text/plain format
Generate DOI	PUT	/doi	Metadata in XML format. DOI in XML will be replaced.	url (required): Target URL for this DOI suffix (optional): Desired suffix for this DOI	HTTP Status: 201 - CREATED Body: created DOI in text/plain format
Update DOI	POST	/doi/{doi}	Metadata in XML format (optional), if it should be updated. DOI in XML will be replaced.	url (optional): Target URL for this DOI, if it should be updated	HTTP Status: 201 - CREATED Body: Metadata in application/xml format Header 'Location': Target URL of DOI
Get DOI	GET	/doi/{doi}	-	-	HTTP Status: 200 - OK Body: Metadata in application/xml format Header 'Location': Target URL of DOI
Get DOI List	GET	/doi	-	-	HTTP Status: 200 - OK Body: DOIs in text/plain format
Inactivate DOI	DELETE	/doi/{doi}	-	-	HTTP Status: 200 - OK

Exceptions

• DoxiException as super class
  • DoiAlreadyExistsException
    • StatusCode: 409
    • Message: This DOI already exists. You can either choose another DOI for creating a new DOI or update the existing one by using the update methode.
  • DoiInvalidException
    • StatusCode: 400
    • Message: This DOI already exists. You can either choose another DOI for creating a new DOI or update the existing one by using the update methode.
  • UrlInvalidException
    • StatusCode: 400
    • Message: The transfered URL is invalid. This can for example be caused by a syntax error.
  • MetadataInvalidException
    • StatusCode: 400
    • Message: Datacite response message if available
    • Alternative Message: The transfered metadata xml is invalid. Please refer to the datacite xml schema (https://schema.datacite.org/).
    • MetadataXml included
  • DoiRegisterException
    • StatusCode: 400
    • Message: Datacite response message if available
    • Alternative Message: The DOI could not be registered at the datacite service.

Max Planck Digital Library

Digital Object Identifier

Representational State Transfer

Application Programming Interface

HyperText Transfer Protocol

Uniform Resource Locator

Extensible Markup Language