Persistent Identifiers in EUDAT services: EPIC API

14
www.eudat.eu EUDAT receives funding from the European Union's Horizon 2020 programme - DG CONNECT e-Infrastructures. Contract No. 654065 Persistent Identifiers in EUDAT services EPIC API This work is licensed under the Creative Commons CC-BY 4.0 licence. Attribution: EUDAT – www.eudat.eu

Transcript of Persistent Identifiers in EUDAT services: EPIC API

Page 1: Persistent Identifiers in EUDAT services: EPIC API

www.eudat.eu

EUDAT receives funding from the European Union's Horizon 2020 programme - DG CONNECT e-Infrastructures. Contract No. 654065

Persistent Identifiers in EUDAT services

EPIC API

This work is licensed under the Creative Commons CC-BY 4.0 licence.Attribution: EUDAT – www.eudat.eu

Page 2: Persistent Identifiers in EUDAT services: EPIC API

PID Training

Content

Data and Persistent Identifiers

PID Service - ePIC API

Data life cycle

Data life cycle with PID

The API: Step by Step

Page 3: Persistent Identifiers in EUDAT services: EPIC API

PID Training

What do we want from data?

Findable – Easy to find by both humans and computer systems Metadata

Accessible – Stored for long term, accessed and/or downloaded with well-defined license and access

Interoperable – Ready to be combined with other datasets by humans as well as computer systems;

Reusable – Ready to be used for future research and to be processed further using computational methods.

Page 4: Persistent Identifiers in EUDAT services: EPIC API

PID Training

What do we know about Persistent Identifiers?

A Persistent Identifier, also known as PID, is an identifier that is effectively permanently assigned to a resource.

identifier resource location

a permanent name or identity

although it may change over time

1. points to a resource(s) 2. globally unique3. PID is persistent over time

Page 5: Persistent Identifiers in EUDAT services: EPIC API

PID Training

Use persistent identifier for your data

Managing data online, includes managing the persistent identifier (PID) for the data.

Synchronize PID, Data during creation, maintenance, update and deletion of your data!

PID should always be updated to point to the new location (URL). continue to provide the latest information about the resource.

Page 6: Persistent Identifiers in EUDAT services: EPIC API

PID Training

What do you actually need ?

a PID service, that offers an API for creating and managing PIDs

EUDAT has adopted Handle-based persistent identifiers

Some EUDAT services require integration of Handle in your infrastructure

EUDAT offers a a service dedicated to provide, resolve and mint persistent identifiers (PID) supported by the ePIC consortium.

Page 7: Persistent Identifiers in EUDAT services: EPIC API

PID Training

The Basics of ePIC

ePIC was founded in 2009 by a consortium of European partners in order to provide PID services for the European Research Community, based on the handle system. ePIC:

targets mainly at data management of individual resources allowing association of extra data with the PID: checksum, link to flexible metadata, …is only a steward for the PIDs, no lock-inis totally compatible with the DOI system, and a PID (including the prefix) can also be interpreted from any DOI serverdoes not tie you in to a domain-specific, esoteric technology  but gives you access to a global identifier, interchangeable with others of this type

Page 8: Persistent Identifiers in EUDAT services: EPIC API

PID Training

PID Service - ePIC API

manage PID

list PID

API

create

list

get

search

update

delete

POST

PUT

DELETE

GET

GET

GET

well documented

doc.pidconsortium.eu

with access to python, perl, php scripts which wraps the PID service

Page 9: Persistent Identifiers in EUDAT services: EPIC API

PID Training

Data life cycle

Publish online

Move to another location

used by another

researcher

has a life cycle, which involves it going online, accessed by users

Published online: http://www.test.com/test.html

Other users may cite, access, re-use this url

Relocate the resource at http://www.example.com/

Other users are not informed -> 404

Page 10: Persistent Identifiers in EUDAT services: EPIC API

Data Life Cycle with PID system

Publish online

Move to another location

used by another

researcher

has a life cycle, which involves it going online, accessed by users

API

PIDs are subject to the same life cycle

ResolvePID

ResolvePID

ResolvePID

Register PID

Update PID

Get PID Details

HandleResolutionservice

Page 11: Persistent Identifiers in EUDAT services: EPIC API

PID Training

Step by Step API

Register for a PID with a POST requestRegister for a PID with a PUT requestGET the details of a PIDUPDATE a PID with a PUT requestDELETE a PID Search for a PID List all PIDs

Page 12: Persistent Identifiers in EUDAT services: EPIC API

Hands-on material

Material on PID hands-on (part 7a)Hands-on tutorial which shows how to:

Create, manage and delete PIDsEmploy HTTP restful API with cURL

https://github.com/EUDAT-Training/B2SAFE-B2STAGE-Training

Training module which provides hands-on material for:

EUDAT B2SAFEiRODS4B2HANDLEand the EUDAT B2STAGE service.

Page 13: Persistent Identifiers in EUDAT services: EPIC API

Thanks

Page 14: Persistent Identifiers in EUDAT services: EPIC API

www.eudat.eu

Authors Contributors

This work is licensed under the Creative Commons CC-BY 4.0 licence

EUDAT receives funding from the European Union's Horizon 2020 programme - DG CONNECT e-Infrastructures.Contract No. 654065

Themis Zamani, GRNET Ellen Leenarts, DANSChristine Staiger, SURFsara

Thank you