ORCID API
An	introduc+on	with	samples	
Andrea	Bollini	(CTIO)		
<andrea.bollini@4science.it>	
November 2016
•  ORCID	data	model		
•  Security	model	
•  ORCID-XML	structure		
•  Example	of	use	of	APIs	from	DSpace-CRIS	
Agenda
Research centric data model
Affilia+ons	
-  Educa+on	
-  Employment	
Fundings	
Start	/	End	dates;	Role	+tle;	
Department	name;	Organiza+on	
(with	ID	as	much	as	possible)	
Works	
Title,	Journal,	Abstract,	Cita+on,	
Type,	publica+on	date,	iden+fiers,	
url,	contributors,	language,	
country	
Start	/	End	dates;	Title,	
Descrip+on,	inves+gators,	
Types,	iden+fiers,	Funder	
(with	ID	as	much	as	possible)
Common proper9es
Put-code:	an	internal	ID	for	such	data	
in	the	ORCID	database	to	use	for	
update	(in	v2)	
	
Visibility:		public	/	private	/	protected	
	
Last-Modified	/	Created	Date	
	
Source:	who	has		added	such	
informa+on	(the	researcher		itself	or	
a	trusted	applica+on)
Visibility
Public:	the	informa+on	is	shown	in	the	
public	ORCID	profile	everyone	can	access	it	
also	via	API	
Protected:	the	informa+on	is	available	only	
to	applica+ons	trusted	by	the	researcher	via	
API	(and	the	researcher	itself)	
Private:	the	informa+on	is	available	only	to	
the	researcher,	the	trusted	individual	
(delegate)	and	eventually	to	the	applica+on	
that	have	added	the	informa+on	via	API
Slide	courtesy	of	ORCID
hp://orcid.org/organiza+ons/integrators/API
How to get the API
•  Public	API	can	be	requested	for	free	by	any	person	
who	holds	an	ORCID	ID	
•  Demonstra+on:		
tutorial-eurocrisdays@mailinator.com	/	t3s3st	
hps://sandbox.orcid.org/developer-tools		
•  Member	API	are	reserved	to	ORCID	members,	can	
be	requested	using	a	web	form	
hps://orcid.org/content/register-client-applica+on-produc+on-
trusted-party		
•  A	sandbox	environment	is	available	for	anyone	also	
to	test	member	&	premium	API	
	hps://orcid.org/content/register-client-applica+on-sandbox
Authoriza9on and security
•  The	ORCID	API	uses	OAUTH2	as	authoriza+on	
model	
•  Client	is	authen+cated	using	client_id	&	client_secret	
•  Ask	authoriza+on	to	the	researcher	to	perform	some	
ac+ons	(scopes	/read-limited,	/orcid-bio/update,	etc.)	
•  Receive	an	authen+ca+on	token	to	use	in	the	
subsequent	API	calls	
•  How	it	looks	like	to	the	user:	
hp://dspacecris.eurocris.org/		
	
hps://dspace-cris.4science.it
Slide	courtesy	of	ORCID
Slide	courtesy	of	ORCID
The request URI structure
hps://members.orcid.org/api/explore-orcid-api-google-oauth-playground
How to READ informa9on
hps://members.orcid.org/api/tutorial-retrieve-data-orcid-record
ORCID Message Schema
Current	version	1.2	
Release	candidate	2.0	
	
ORCID	–	XML	have	4	sec+ons	
•  <orcid-iden+fier>	&	<orcid-history>	reserved	to	
informa+on	managed	by	the	registry	
•  <orcid-bio>	contains	the	personal	informa+on	of	
the	researcher	
•  <orcid-ac+vi+es>		contains	the	informa+on	related	
to	all	the	ac+vi+es	of	the	researcher:	works,	
affilia+on,	funding
hps://members.orcid.org/api/record-xml-structure
hps://members.orcid.org/api/record-xml-structure
hps://members.orcid.org/api/record-xml-structure
hps://members.orcid.org/api/record-xml-structure
hps://members.orcid.org/api/record-xml-structure
How to use it
•  Demo:	hps://dspace-cris.4science.it
•  You	need	member	API	for	that!	
•  You	can	POST	or	PUT	
•  POST:	create	addi+onal	informa+on	à	append	
•  PUT:	replace	all	the	informa+on	owned	by	your	
applica+on	
•  You	can	update/create	specific	sec+on	or	subparts	
•  <ORCID-ID>/orcid-bio	
•  <ORCID-ID>/affilia+ons	
•  <ORCID-ID>/orcid-works	
•  <ORCID-ID>/finding	
•  More	details	hps://members.orcid.org/api/api-calls		
How to update informa9on
How to use it
•  Demo:	hps://dspace-cris.4science.it
How to get support & more informa9on
•  Extended	online	documenta+on:	
	hp://members.orcid.org/api	
	
•  GitHub	ORCID	repository	
	hps://github.com/ORCID/ORCID-Source		
	
•  Google	group:	 	
hps://groups.google.com/forum/#!forum/orcid-api-users	
•  ORCID	Support:	
	support@orcid.org
Andrea	Bollini	(CTIO)		
<andrea.bollini@4science.it>	
mobile:	+39	333	934	1808	 			
skype:	a.bollini	
linkedin:	andreabollini	 		
orcid:	0000-0002-9029-1854	
Thanks for your aJen9on

4Science presentes: ORCiD API Tutorial