How to use the DataCite Metadata
Use of MDS
Register a dataset
Update a dataset
Upload metadata file
Find my dataset
Register many datasets
Update many datasets
Upload many metadata files
Retrieve a metadata file
Story: Register a dataset
As a datacentre, I would like to register one of my
I know the URL of the landing page and DOI name I want
to assign to the datasets.
I also have a valid XML file with the metadata to my
dataset according to DataCite's standards.
Implementation: Register a dataset
Use web interface:
Result: A DOI will be minted and a record in Metadata Store created.
Story: Find my dataset
As a datacentre, I registered a dataset and I now want to
find it in the Metadata Store.
• RestFul API
• HTTPS with Basic Authentication
• Full documentation:
Example API Calls
curl -u USER.NAME
-H "Content-Type: application/xml"
Mint or Update a DOI:
curl -u USER.NAME
Little things matter
remember setting appropriate headers:
Pay attention to the response codes – they
mean what they say!
Additional message can be included in the
response body e.g.
Response code: 403 Forbidden
response body: user quota exceeded
• Prefix is defined by DataCite
• Suffix is defined by data center
• Opaque string
• Characters for a DOI name:
A – Z
a – z
0 – 9
No umlauts or special characters!
• You may only use prefixes and domains assigned to
• It may be that you have a DOI quota. Once this is
fulfilled you cannot register any more DOIs.
It’s distributed – be aware of latency!
• The Handle System – the technical infrastructure for
DOIs – is a distributed network system.
• Newly minted DOIs should be resolvable after about 5
• Updates to DOIs can take up to 24 hours before being
distributed through the whole Handle system.
You cannot delete DOIs!
• A DOI is a persistent identifier so removing it
would go against the idea.
•It’s still possible to deaccesses a dataset, but this
should be noted on the DOI‘s landing page.
• A DOI should always resolve to a landing page
where metadata and information on how to access
the dataset are given.
DataCite has a whole test environment where all
services can be tested:
Resolver for test DOIs: http://dx.test.datacite.org