1. How to use the DataCite Metadata
2. 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
3. Single operations
4. 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.
5. Implementation: Register a dataset
Use web interface:
Result: A DOI will be minted and a record in Metadata Store created.
6. Story: Find my dataset
As a datacentre, I registered a dataset and I now want to
find it in the Metadata Store.
7. Implementation: Find my dataset
8. Story: Update a dataset
As a datacentre, I registered my dataset but I now want to
change the URL of its landing page.
9. Implementation: Update a dataset
Find dataset and edit it:
10. Story: Update metadata file
As a datacentre, I had already registered my dataset and
now I want to update the metadata file.
11. Implementation: Update metadata file
12. Bulk operations
• RestFul API
• HTTPS with Basic Authentication
• Full documentation:
14. Example API Calls
curl -u USER.NAME
-H "Content-Type: application/xml"
Mint or Update a DOI:
curl -u USER.NAME
15. 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
16. DOI names
• 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.
18. 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.
20. Test Environment
DataCite has a whole test environment where all
services can be tested:
Resolver for test DOIs: http://dx.test.datacite.org