paso 3 (de 5)
3. Escriba a un ORCID registro (POST)
¡Felicidades! Ha configurado todo y está recopilando iD y permisos, ¡ahora viene la parte divertida! En esta lección aprenderá a escribir datos en un ORCID registro.
En esta sección, agregaremos una afiliación de "educación" a su registro de Sandbox.
En el siguiente ejemplo estamos usando el punto final /educación con el XML correcto para agregar la información, pero también puede agregar Empleo o Trabajos, por ejemplo. Vea nuestro Documentación de Github para obtener más archivos de ejemplo y puntos finales y los permisos que necesita para cada uno.
Aquí hay un ejemplo de XML educativo que puede usar para este ejercicio:
<?xml version="1.0" encoding="UTF-8"?>
<education:education
xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">
<common:department-name>department-name</common:department-name>
<common:role-title>role-title</common:role-title>
<common:start-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:start-date>
<common:end-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:end-date>
<common:organization>
<common:name>common:name</common:name>
<common:address>
<common:city>common:city</common:city>
<common:region>common:region</common:region>
<common:country>AF</common:country>
</common:address>
<common:disambiguated-organization>
<common:disambiguated-organization-identifier>http://dx.doi.org/10.13039/100000001</common:disambiguated-organization-identifier>
<common:disambiguation-source>FUNDREF</common:disambiguation-source>
</common:disambiguated-organization>
</common:organization>
<common:url>http://tempuri.org</common:url>
<common:external-ids>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value</common:external-id-value>
<common:external-id-url>http://tempuri.org</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value2</common:external-id-value>
<common:external-id-url>http://tempuri.org/2</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
</common:external-ids>
</education:education>
Regrese a la pestaña del navegador para Google Developers OAuth 2.0 Playground. Si no mantuvo la pestaña abierta, puede reiniciar la sesión con la URL que guardó anteriormente (haciendo clic en Aceptar en la advertencia que aparece). O puede configurar la llamada nuevamente completando todos los campos relevantes, asegurándose de que se vean como las capturas de pantalla a continuación:
Asegúrese de que el configuración tiene su cliente ID y secreto del cliente
Debajo del Paso 2 dentro del área de juegos de google oauth, debe tener su Token de acceso rellenado
Todavía debería tener el token de antes o puede completarlo del ejercicio anterior de esta manera:
Debajo del Paso 3 dentro de Google Developers OAuth 2, haga clic en el área de juegos Agregar encabezados, ingrese los valores a continuación, luego haga clic en Añada y Cerrar
Header name: Accept
Header value: application/vnd.orcid+xml
Debajo del Paso 3: Configurar solicita a APIestablecer Método HTTP a CORREO.
En Solicitar URI campo ingrese:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Reemplazar [ORCID DNI] con el iD para su registro de Sandbox, formatee XXXX-XXXX-XXXX-XXXX con el que obtuvo permiso para interactuar.
Haga Clic en Tipo de contenido > Personalizado e introduzca
application/vnd.orcid+xml
Haga Clic en AñadaY, a continuación, haga clic Cerrar.
Haga Clic en Ingrese el cuerpo de la solicitud.
Copie el XML de afiliación educativa en la parte superior de esta sección y péguelo en el Cuerpo de solicitud caja de texto:
OPCIONAL: En Cuerpo de solicitud cuadro de texto, edite el XML para reflejar su institución. Para , utilizar el Registro ROR para encontrar el ROR ID para tu institucionn.
Haga Clic en Cerrar.
Haga Clic en Enviar la solicitud.
Los resultados aparecerán en la Solicitar respuesta sección de la derecha. Desplácese hasta el final de la respuesta, si ve HTTP / 1.1 201 Creado, ¡su afiliación educativa se agregó con éxito! A continuación puede ver un extracto de un ejemplo de cómo aparecerá el XML con el mensaje 201 creado en la parte inferior.
... <common: month>01</common: month> <common: day>01</common: day>
</ common: start-date> <education:organization>
<common: name>My University</common: name> <common: address>
<common: city>Some City</common:city> <common: region>Region</common: region> <common: country>US</common:country>
</ common: address>
HTTP/1.1 201 Created
Content length. A X-xss-protection: 1; mode=block X-content-type-options: nosniff
Expires: 0
Server: nginx/1.10.0
Connection: keep-alive
Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pragma: no-cache
Cache-control: no-cache, no-store, max-age=0, must-revalidate
Date: Thu, 15 Jun 2017 20:44:09 GMT
Access-control-allow-origin: *
Content-type: application/vnd.orcid+xml: qs=5;charset=UTF-8
X-frame-options: DENY
¡Guarde su código puesto, será necesario en la siguiente sección para actualizar los artículos!
Guarde su código de entrada
Los códigos de venta son códigos numéricos cortos que hacen referencia a un elemento en particular en el ORCID registro.
Cuando publica un elemento en el registro de un investigador, la respuesta de la API contendrá el código de colocación de ese elemento. Puede almacenar el código de colocación para usarlo más tarde si necesita leer, actualizar o eliminar ese elemento.
En el ejemplo anterior, el código de colocación son los 5 dígitos al final de esta línea: Ubicación: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Si hay un error en su respuesta, verifique que no haya errores tipográficos en sus etiquetas XML y que haya ingresado todos los demás detalles correctamente. ¡El más mínimo error tipográfico puede romperlo todo!
Visite la vista pública de su registro de Sandbox en https://sandbox.orcid.org/[ORCID ID] para ver su nueva afiliación educativa.
Tenga en cuenta que Source muestra el nombre del cliente API que agregó la afiliación: este es un elemento clave que ayuda a otros sistemas a consumir ORCID Los datos determinan si esta pieza de información es fidedigna.