Introduccion tecnica de la api - 2015 espana seminario tecnico

orcid.org

Contact Info: p. +1-301-922-9062 a. 10411 Motor City Drive, Suite 750, Bethesda, MD 20817 USA

introducción técnica de la API
ORCID workshop técnico, España

2015 enero 27

angel montenegro

a.montenegro@ost.ORCID.org

http://orcid.org/0000-0002-7869-831X

Contact Info: p. +1-301-922-9062 a. 10411 Motor City Drive, Suite 750, Bethesda, MD 20817 USA

orcid.org

la API de ORCID
orcid.org

•  autenticar: obtener un identificador ORCID de un
usario autenticado

•  leer: leer la información pública y limitada

•  añadir: publicar nuevos items* en el registro

•  actualizar: actualizar o borrar items* que previamente
habías añadido

PHOTO: electronic circuit board
www.flickr.com/photos/creative_stock/5227842611
*publicaciones, subvenciones, afiliaciones o información biográfica

integración con universidades
orcid.org

ORCID se enlaza cuando...

•  cuando hay nuevas facultades o estudiantes – se facilita la
creación de iDs

•  al ﬁnalizar una tesis – se añade el iD a la publicación y la
publicación se agrega al record ORCID

•  cuando un sistema o repositorio actualiza tu perﬁl – se
sincronizan las actividades del investigador entre los dos sistemas

•  reportes y evaluaciones – se sincronizan las actividades del
investigador entre los dos sistemas

members.orcid.org/research-organizations

integración con otros sistemas
orcid.org

sistemas de información o de perﬁles:

•  se facilita la creación de iDs

•  guarda y muestra el iD del investigador en su sistema

•  sincroniza la información biográﬁca entre los sistemas

•  sincroniza las actividades del investigador entre los dos
sistemas

members.orcid.org/research-organizations

integración con otros sistemas
orcid.org

•  repositorios – DSpace 5 objetivos:

•  asegurarse de que el ORCID iDs ha sido asociado a las nuevas
publicaciones

•  efectúa eﬁcientemente la actualización por lotes con un
identiﬁcador de autor no ambiguo

•  repositorios – DSpace 5 características:

•  añade o actualiza autores por medio de búsqueda y realiza
actualizaciones por lotes por medio de archivos csv

•  enlaza ORCID iDs y nombres alternativos a la metadata de los
autores

•  soporta authority key para ORCID

wiki.duraspace.org/display/DSDOC5x/ORCID+Integration

integración con agencias de financiación
orcid.org

•  aplicaciones: recoge el iD de los aplicantes y su
información biográﬁca

•  revisión: recoge el iD y la información biográﬁca del
revisor así como su lista de actividades

•  premios y reconocimientos: actualiza los registros de
orcid del premiado y el revisor

members.orcid.org/funders

integración con los editores
orcid.org

•  envío: obtiene el iD y la información biográﬁca del autor

•  revisión: obtiene el iD y la información biográﬁca del
revisor, así como su lista de actividades

•  producción: incluya el iD en la metadata de la
publicación así como en el documento

•  publicación: actualice el record de ORCID del autor y el
revisor

members.orcid.org/publishers

API tecnologías
orcid.org

•  REST: interactúa con el API por medio de llamados
HTTP

•  OAuth: proceso de autenticación de 3 pasos

•  XML / JSON: formatos utilizados para el
intercambio de datos


el mensaje XML de ORCID
orcid.org

tiene 4 partes:

•  <orcid-identifier> y <orcid-history>:
información generada por el sistema sobre el registro

•  <orcid-bio>: información personal sobre el investigador

•  <orcid-activities>: información sobre el investigador
que incluye publicaciones, subvenciones, vida laboral y educación

versiones:

•  trabaja en la versión 1.2

•  nuevas funcionalidades en release candidates

github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/README.md

privacidad del usario
orcid.org

la información en el registro ORCID posee diferentes
niveles de privacidad, los cuales pueden ser modiﬁcados
por el dueño del registro.

la información del registro

(conﬁguración, permisos) es

accedida por el dueño del

mismo.


creando registros con el API
orcid.org

creando bajo demanda

•  se envía un email pidiéndole registrarse y obtener un
ORCID iD

•  al presionar el link, el investigador es enviado a la pagina de
registro de ORCID

•  el usuario crea un nuevo registro ORCID

•  le concede permisos para agregar información a su registro

•  el usuario es re direccionado a un sitio que usted deﬁne
previamente


conectándose con el API
orcid.org

como se añaden actividades al record ORCID

•  solicite permisos al autor

•  el autor otorga permisos, su sistema obtiene un código

•  su sistema intercambia el código por un access token

•  utilizando el access token, se lee el record ORCID del
autor para proveer información en tu sistema

•  el autor selecciona las actividades a añadir

•  su sistema agrega las actividades al record del autor


solicite permisos al autor
orcid.org

usuario:

•  sigue un link para conectar tu sistema a su registro
ORCID

sistema:

•  envía al usuario a la URL de autorización


permiso concedido
orcid.org

usuario:

•  autoriza la conexión

sistema:

•  recibe un código de
autorización y el ORCID
iD del usuario


intercambia el código
orcid.org

usuario: ninguna

sistema:

•  cambia el código de autorización por un access token

curl -i -L -H 'Accept: application/json' --data
'client_id=0000-0002-9189-9909&client_secret=719b5c31-5681-4dce-a317-
ff1bc1e94277&grant_type=authorization_code&code=GU0yrC&redirect_uri=https://
developers.google.com/oauthplayground' 'https://api.qa.orcid.org/oauth/token' -k
HTTP/1.1 200 OK
{"access_token":"0a3ac65f-f8a7-4257-b605-aff0ab37d464",
"token_type":"bearer",
"refresh_token":"16d75d2d-bb75-4087-8a01-685e5f03faf8",
"expires_in":631138518,
"scope":"/orcid-profile/read-limited",
"orcid":"0000-0003-4153-0078”}

lee el record ORCID
orcid.org

usuario: ninguna

sistema:

•  usa el access token para leer el registro del usuario

•  muestra información sobre lo que está en el registro

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orcid-message xmlns="http://www.orcid.org/ns/orcid">
<message-version>1.2_rc3</message-version>
<orcid-profile type="user">
<orcid-identifier>
<uri>http://qa.orcid.org/0000-0003-4153-0078</uri>
<path>0000-0003-4153-0078</path>
<host>qa.orcid.org</host>
</orcid-identifier>
…

el autor decide que añadir
orcid.org

usuario: selecciona items para añadir a su registro ORCID

sistema: usa el access token para publicar información


el registro está actualizado
orcid.org


recursos
orcid.org

pasos técnicos para la integración

•  conseguir credenciales para el sitio de pruebas sandbox
- sandbox.orcid.org

•  formalizar una integración en sandbox

•  trabajar con el personal de ORCID para probar la
integración en sandbox

•  lanzar su integración en el registro en vivo de ORCID


recursos
orcid.org

pasos no técnicos

•  educar a tus investigadores sobre ORCID

•  publicar artículos y notas internas sobre ORCID

•  usar el logo de ORCID en tus páginas web

•  compartir material promocional

•  alojar workshops

•  educar a los administradores sobre ORCID

•  crear documentación para tu integración

•  publicitar la integración cuando esta sea completada


recursos
orcid.org

•  empezar con la guía de la API
http://support.orcid.org/knowledgebase/articles/180285

•  ORCID knowledge base

•  guías generales: http://support.orcid.org/knowledgebase/topics/32828

•  tutoriales detallados: http://support.orcid.org/knowledgebase/topics/32831

•  grupo de usuarios de la API de ORCID
https://groups.google.com/forum/#!forum/orcid-api-users

•  comprobar otras integraciones
https://orcid.org/organizations/integrators/current

•  Soporte en ORCID
http://support.orcid.org o support@orcid.org


Introduccion tecnica de la api - 2015 espana seminario tecnico

Recomendados

Recomendados

Más contenido relacionado

Similar a Introduccion tecnica de la api - 2015 espana seminario tecnico

Similar a Introduccion tecnica de la api - 2015 espana seminario tecnico (20)

Más de ORCID, Inc

Más de ORCID, Inc (20)

Último

Último (13)

Introduccion tecnica de la api - 2015 espana seminario tecnico