persistent identifiers in eudat services: epic api
TRANSCRIPT
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
PID Training
Content
Data and Persistent Identifiers
PID Service - ePIC API
Data life cycle
Data life cycle with PID
The API: Step by Step
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.
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
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.
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.
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
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
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
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
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
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.
Thanks
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