Como organización de investigación, usted se encuentra en una posición única para conectar información validada y confiable sobre sus investigadores y su afiliación con usted a sus ORCID registros. Esto le permite tomar el control de cómo se usa su nombre en la literatura de investigación y le permite realizar un seguimiento fácil del personal anterior, los estudiantes y el cuerpo docente. Facilita que sus investigadores compartan información precisa y autorizada sobre su afiliación con su institución al solicitar subvenciones, publicar un artículo, libro o base de datos, y más.
Estos flujos de trabajo son aplicables a la gestión de estudiantes, matrícula, recursos humanos y sistemas de perfiles.
Flujo de trabajo 1: recopilación de iD dentro de sus sistemas
- Al registrar sus datos a través de un formulario web, se solicita a los registrantes que autentiquen su ORCID iD y conceda permiso a su organización para interactuar con su registro.
- Una vez que se aprueba su registro, su sistema actualiza la sección correspondiente de la ORCID registrar con detalles de su puesto o distinción, conectándolos con su organización.
- Mostrar su autenticado ORCID iD junto con cualquier información disponible públicamente sobre ellos.
Flujo de trabajo 2: recopilación de ID de forma retrospectiva
Si su sistema ya contiene información sobre sus investigadores y sus actividades pasadas, o si no hay un componente de registro, puede en su lugar:
- Envíe un correo electrónico a las personas con un enlace único que pueden usar para conectarse con su sistema.
- Cuando se hace clic en él, este enlace dirige a la persona a ORCID para autenticar su iD y conceda permiso a su organización para actualizar su registro.
- Luego, los redirige a una página web creada especialmente que usted proporciona.
- Su sistema almacena el enlace entre el ORCID iD y dirección de correo electrónico / cuenta de usuario, y utiliza los permisos que la persona ha otorgado para actualizar la sección correspondiente de su ORCID registrar, conectándolos a ellos y su actividad con su organización.
- Mostrar su autenticado ORCID iD junto con cualquier información disponible públicamente sobre ellos.
Las afirmaciones de afiliación contienen fechas de inicio y fechas de finalización, y le recomendamos encarecidamente que complete estos campos siempre que sea posible, ya que esto facilita la verificación de la afiliación del investigador con su organización. Los flujos de trabajo anteriores habilitan permisos de actualización a largo plazo, que se pueden usar para actualizar la fecha de finalización cuando finaliza la afiliación de una persona. Su sistema debe utilizar el ORCID API para agregar una fecha de finalización (cuando corresponda), a fin de aclarar el término completo de la afiliación.
Ejemplo
Beneficios
Puede ayudar a sus investigadores a obtener crédito conectando información validada sobre su afiliación con usted a su ORCID registros. Al mismo tiempo, ayudará a generar confianza en las comunicaciones académicas. Al afirmar la conexión entre las personas y su organización, conexiones que solo su organización puede establecer con autoridad, se asegura de que su organización reciba el debido reconocimiento cuando sus empleados y afiliados realicen contribuciones profesionales. Luego, esa información se puede compartir, con el permiso del investigador, con los otros sistemas con los que interactúan, lo que ayuda a crear una infraestructura de información de investigación confiable.
Como resultado de nuestras conversaciones con editores, proveedores e investigadores, hemos desarrollado una estrategia inicial. resumen del registro prototipo. Esperamos que a los editores les resulte más fácil encontrar y comprender la información dentro ORCID registra y saca a la luz el marcadores de confianza que puede ayudarle a tomar decisiones sobre la confiabilidad de un ORCID registro.
¿Qué información se muestra dentro del resumen?
Dependiendo de qué datos públicos estén disponibles en el archivo del autor ORCID El registro dependerá de la información que se mostrará. A continuación se muestra la lista de elementos que pueden mostrarse:
- Nombre o nombre publicado/crédito: si el registro tiene un nombre publicado, se mostrará, pero si no, se mostrará el nombre.
- ORCID iD
- Afiliaciones: esta sección muestra únicamente elementos de empleo. Nombre de la organización con un enlace a la URL de afiliación (si se incluye), función, fechas (si se incluyen). Se muestran en orden cronológico del más nuevo al más antiguo. Se muestran 3 afiliaciones, si corresponde, con un recuento adicional de afiliaciones adicionales en el registro.
- Obras: recuento de obras validadas y obras autoafirmadas
- Revisión por pares: recuento de elementos de revisión por pares validados. Tenga en cuenta que esto solo mostrará un recuento de elementos validados, ya que los usuarios no pueden agregar manualmente la revisión por pares a sus registros.
- Financiamiento: un recuento de financiamiento validado y financiamiento autoafirmado
- Actividades profesionales: esta sección muestra los 3 elementos más recientes de Membresía, Servicio, Puestos invitados y Distinciones. Estos se muestran en orden cronológico del más nuevo al más antiguo.
- Otros identificadores: esta sección muestra los otros identificadores que se han conectado con la cuenta del usuario. ORCID identificación. Por ejemplo, ID de autor de Scopus, ISNI o ID de investigador.
- Fechas clave: las fechas incluyen la fecha en que se creó el registro y la fecha en que se actualizó por última vez.
¿Cuál es la diferencia entre los elementos validados y autoafirmados?
El icono de fuente que se muestra junto a los diferentes elementos muestra si el elemento fue agregado al registro de autores por una persona confiable. ORCID organización miembro o por el propio autor
- Validado: agregado por un confiable ORCID organización miembro
- Autoafirmado – Agregado directamente por el autor
¿Por qué no se muestra información aparte de las fechas clave?
El control individual es un principio básico de la ORCID Programa de confianza. ORCID Los titulares de registros controlan qué información se agrega y elimina de sus ORCID registro, con control detallado sobre la visibilidad de la información y control sobre qué organizaciones e individuos confiables pueden acceder a su registro para leer, escribir o actualizar su información.
La acreditación ORCID iD siempre está disponible públicamente, pero el titular del registro puede controlar la configuración de visibilidad de todos los demás elementos dentro de su registro. El resumen solo mostrará elementos que tengan la configuración de visibilidad "Todos", ya que se muestran en la versión pública de los usuarios de su ORCID registro.
¿Por qué el registro muestra que está bloqueado, obsoleto o desactivado?
Cuando un ORCID registro tiene uno de los estados anteriores, entonces no hay datos públicos disponibles en el ORCID registro.
- Bloqueado = el registro no cumple con nuestros términos de servicio
- Obsoleto = el registro ha quedado obsoleto en otro ORCID iD
- Desactivado = el registro ha sido desactivado por el usuario
Visita nuestra Grupo de usuarios de API temas para obtener más información sobre cómo configurar una integración con la API pública. Sin embargo, para maximizar los beneficios de ORCIDte recomendamos únete ORCID como miembro de la organización, que ofrece acceso a funciones adicionales, asistencia personal de nuestro equipo de integración y, por supuesto, ayuda a respaldar nuestro trabajo.
Las credenciales de Cliente público se otorgan a individuos y no a organizaciones. Las credenciales no se pueden transferir de un individuo a otro, pero se pueden convertir en credenciales API de miembros si se recibe el acuerdo de todas las partes y la organización es un miembro activo de ORCID.
Mover el ID del cliente a la API de miembro no alterará el ID del cliente, solo el secreto del cliente, y conservará la cantidad de iD conectados con su permiso de solo lectura.
Al convertir el cliente de la API pública en un cliente de la API miembro, el Condiciones de servicio para clientes públicos ya no se aplican, y se sustituyen por los términos del Acuerdo de miembro.
Para la transferencia necesitaríamos:
- Confirmación del ID de cliente de API pública que se convertirá.
- Que el contacto principal de la organización y el titular del registro del ID de cliente de la API pública actual estén de acuerdo con el cambio en los Términos de servicio. (El titular del registro debe ser un empleado, contratista o funcionario de la organización miembro). Mantendremos un registro del consentimiento de ambas partes.
- Una fecha y hora para que se realice la migración. Como parte de esta migración, actualizaremos el ID del cliente y le enviaremos un nuevo secreto de cliente en un correo electrónico cifrado. Tenga en cuenta que una vez que actualicemos el cliente, su integración no funcionará hasta que actualice el secreto de cliente. Es por eso que necesitamos fijar una fecha y hora para que esto se realice y evitar inconvenientes para los usuarios.
Para que se complete la conversión, deberá actualizar:
- El antiguo secreto de cliente al nuevo secreto de cliente.
- El host de la API de pub.orcid.org a api.orcid.org.
Con su ID de cliente de API de miembro convertido, puede actualizar los ámbitos para agregar alcances de la API miembro. Esto requerirá la autorización de los usuarios y se generarán nuevos tokens de acceso para incluir los nuevos ámbitos/permisos.
Tenga en cuenta que no podemos convertir las credenciales de los clientes de la API de miembros en credenciales de la API pública.
Miembros del Consorcio – Una lista de los miembros de su consorcio con un recuento de afiliaciones. Desde esta lista puede acceder al informe de afiliación de miembros individuales para ver los datos de afiliación con más detalle. Sin embargo, para profundizar, seleccione el miembro de la lista, haga clic derecho, seleccione profundizar y luego haga clic en el informe correspondiente.
ID de la organización miembro del consorcio: Una lista de los ID de organización registrados de los miembros de su consorcio, incluidos el tipo de identificador, el valor y el nombre.
Esta llamada de ejemplo recupera un resumen de la ORCID registro en formato XML utilizando la API miembro en el servidor de espacio aislado. Necesita un token de acceso para realizar solicitudes de API a la API pública o miembro.
Method: GET
Accept: application/vnd.orcid+xml
Authorization type and Access token: Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
La API devolverá un mensaje 200 OK, que indica que la solicitud se recibió correctamente y el resumen completo de la ORCID registro, incluidos resúmenes de elementos individuales
<?xml version="1.0" encoding-"UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789"
xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Cada elemento (trabajo, financiación, empleo, etc.) tiene un poner código. Esto se puede utilizar para obtener detalles completos del artículo si es necesario.
Le recomendamos que lea nuestro documentación escrita. Si todavía tiene preguntas y es un ORCID miembro, por favor contacte a soporte; los no miembros pueden unirse a la ORCID Grupo de usuarios de API.
Puede verificar el estado de nuestro servidor de producción y el servidor de sandbox llamando a lo siguiente:
Salvadera
- https://pub.sandbox.orcid.org/{{version}}/pubStatus
- https://api.sandbox.orcid.org/{{version}}/apiStatus
Producción
También puedes consultar un resumen diario en http://status.orcid.org/
La acreditación ORCID El registro se divide en secciones individuales para que la lectura del registro sea más rápida y coherente. Primero puede llamar a una sección para recibir su resumen y luego llamar usando el código de colocación de un artículo individual para recibir información sólida sobre ese artículo.
A continuación se muestra una tabla de las secciones de resumen que puede utilizar la API para leer.
Punto final | Descripción |
/registro | Vista resumida de la ORCID grabar |
/por persona | Sección biográfica del ORCID registro, incluidas las URL de través / investigador a continuación |
/resumen | Vista resumida de elementos validados y autoafirmados en el ORCID registro (solo disponible con la API para miembros) |
/habla a | Los países o regiones del investigador |
La (s) dirección (es) de correo electrónico asociadas con el registro | |
/ identificadores-externos | Identificadores externos vinculados en otros sistemas |
/ palabras clave | Palabras clave relacionadas con el investigador y su trabajo |
/otros nombres | Otros nombres por los que se conoce al investigador |
/detalles personales | Datos personales: nombre del investigador, nombre de crédito (publicado) y biografía |
/ urls-investigador | Enlaces a las páginas personales o de perfil del investigador. |
/ocupaciones | Resumen de la sección de actividades del ORCID registro, incluido a través de / funciona a continuación. |
/ educaciones | Afiliaciones educativas |
/ empleos | Afiliaciones laborales |
/ financiaciones | Resumen de actividades de financiación |
/Revisiones hechas por colegas | Resumen de las actividades de revisión por pares |
/obras | Resumen de trabajos de investigación |
/ recursos-de-investigación | Resumen de recursos de investigación |
/servicios | Resumen de servicios |
/ calificaciones | Resumen de calificaciones |
/ membresías | Resumen de membresías |
/ distinciones | Resumen de distinciones |
/ puestos-invitados | Resumen de puestos invitados |
Para apoyar el componente social, ofrecemos un conjunto de herramientas de Recursos de divulgación para ayudarlo a desarrollar una campaña para respaldar su integración y comunicar a sus investigadores:
- Los ORCID .
- Por qué su sistema recopila iD y cómo realizará las tareas, como actualizar sus registros.
- Por qué sus investigadores se beneficiarán al crear un ORCID iD y conectar sus iD a su sistema.
- Cómo ORCID beneficia a la comunidad de investigación global más amplia.
Continuamente estaremos construyendo esta “biblioteca” de recursos basados en los comentarios de la comunidad. Si tiene una idea de algo que le gustaría ver, no dude en contactarnos.
Esta llamada de ejemplo recupera un resumen de la ORCID registro en formato XML utilizando la API miembro en el servidor de espacio aislado. Necesita un token de acceso para realizar solicitudes de API a la API pública o miembro.
Method: GET Accept: application/vnd.orcid+xml
Authorization type and Access token:
Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
La API devolverá un mensaje 200 OK, que indica que la solicitud se recibió correctamente y el resumen completo de la ORCID registro, incluyendo resúmenes de elementos individuales.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Cada elemento (trabajo, financiación, empleo, etc.) tiene un poner código. Esto se puede utilizar para obtener detalles completos del artículo si es necesario.
Los elementos (trabajos, empleo, financiación, revisión por pares, etc.) se pueden agregar a un ORCID grabar ya sea manualmente o utilizando el ORCID API miembro. Si es una persona que busca actualizar su registro, consulte nuestro sección de ayuda sobre esto aquí. Si es miembro y desea agregar elementos a un ORCID registro, necesitará lo siguiente:
- El permiso de los investigadores
- Credenciales de API de miembro
- Y también:
- Un sistema de proveedores que se integra con el ORCID API de miembros
- Su propio sistema que se integra con el ORCID API de miembros
Para obtener una guía completa para los miembros que utilizan la API para elementos de un registro, consulte nuestro enlace del tutorial de API a continuación:
Antes de que pueda agregar un elemento al ORCID registro, necesitará formatear sus datos en el ORCID esquema. Formatee sus datos en el ORCID esquema de mensaje en XML o JSON.
Nuestro repositorio de GitHub contiene recursos que ayudarán con el formato al crear nuevos elementos en el ORCID registro, y al leer elementos existentes en el ORCID grabar:
Tenga en cuenta que las diferentes versiones de la API tienen diferentes formatos de mensajes. Los esquemas y ejemplos de las versiones 2.0 y 2.1 también están disponibles.
Se pueden encontrar fácilmente más ejemplos leyendo los metadatos de un registro bien poblado.
Los tokens de actualización se utilizan para generar tokens de acceso adicionales. Se devuelve un token de actualización con el token de acceso cuando se intercambia un código de autorización como parte del procesos OAuth de tres patasy se puede utilizar siempre que el token de acceso permanezca activo.
Los nuevos tokens de acceso pueden tener el mismo vencimiento y alcances que el token de acceso original, o se pueden especificar para tener una vida útil más corta, así como un subconjunto más pequeño de alcances del token de acceso original. Se pueden generar nuevos tokens de acceso para reemplazar el token original o generarlos para que sirvan como token adicional. También puede usar las llamadas de token de actualización para caducar por completo el acceso original y los tokens de actualización y cualquier permiso otorgado por el usuario.
Sugerimos usar tokens de actualización en las siguientes condiciones:
- Reemplazo de tokens de acceso que pueden haber sido comprometidos (asegúrese de revocar el token de acceso original después)
- Dar a un tercero que también es parte de su ORCID integración acceso más limitado y / o acceso por tiempo limitado.
Por favor consulte nuestra de documentación técnica sobre cómo crear nuevos tokens de acceso a partir de tokens de actualización.
Versión anterior del ORCID API tenía alcances adicionales. Estos ámbitos se eliminaron gradualmente con la API 2.0. Alentamos a todas las integraciones a usar solo los alcances recomendados. Como referencia, los alcances anteriores se enumeran a continuación con el alcance actual que debe usarse en su lugar
- /orcid-profile/lectura limitada usar en su lugar / lectura limitada
- /orcid-works/lectura limitada usar en su lugar / lectura limitada
- /orcid-bio/limite-de-lecturausaría en su lugar / lectura limitada
- /orcid-works/crear usar en su lugar / actividades / actualización
- /orcid-works/actualización usar en su lugar / actividades / actualización
- / afiliaciones / crear usar en su lugar / actividades / actualización
- / afiliaciones / actualización usar en su lugar / actividades / actualización
- / financiación / crear usar en su lugar / actividades / actualización
- / financiación / actualización utilizar en su lugar / actividades / actualización
- /orcid-bio/actualización usar en su lugar / persona / actualización
- /orcid-bio/identificadores-externos/crear usar en su lugar / persona / actualización
Hay dos ámbitos de actualización diferentes: uno para los detalles biográficos y el otro para las actividades.
<b></b><b></b> | Descripción | Puntos finales API |
/ persona / actualización | Datos biográficos: la columna izquierda del ORCID registro de la interfaz de usuario. | /habla a / identificadores-externos / palabras clave /otros nombres / urls-investigador |
/ actividades / actualización | Datos de la actividad de investigación: la columna derecha del ORCID registro de la interfaz de usuario. | /distinción / distinciones /educación / educaciones /empleo / empleos /fondos / financiaciones / puesto-invitado / puestos-invitados /afiliación / membresías / revisión por pares /Revisiones hechas por colegas /calificación / calificaciones / recurso-de-investigación / recursos-de-investigación /Servicio /servicios /trabaja /obras |
Utilice su ID de cliente, secreto y el token activo o su token de actualización asociado para revocar el par de tokens. Puede revocar los pares de tokens creados tanto en el de dos patas como en el procesos OAuth de tres patas. Si tiene varios conjuntos de tokens, por ejemplo, para diferentes ámbitos, solo se revocará el token de acceso especificado y el token de actualización correspondiente.
Sugerimos revocar tokens en las siguientes condiciones:
- Para revocar tokens emitidos a un proveedor externo después de la terminación de una relación;
- Para revocar tokens cuando los usuarios desconectan sus ORCID iD desde su sistema;
- Permitir a los usuarios revocar tokens desde su sistema.
Recomendamos utilizar el actualizar tokens para limitar el alcance o la duración de un token de acceso existente o actualizar un token si se ha visto comprometido.
La llamada a la API de revocación
https://sandbox.orcid.org/oauth/revoke (or https://orcid.org/oauth/revoke)
METHOD: POST
HEADER: accept:application/json
CONTENT-TYPE: application/x-www-form-urlencoded
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
token=[access token or refresh token for token pair to be revoked]
Todos los elementos (excepto el texto de la biografía) en un ORCID registro tiene un poner código:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
Este código de transferencia se puede utilizar para realizar una llamada a la API para recuperar los datos completos de un artículo. Los siguientes elementos se pueden consultar utilizando un poner código:
Punto final | Descripción |
/ dirección / [poner código] | Un país o región individual |
/biografía | El campo de la biografía: un área de texto libre que solo el investigador puede editar |
/ education / [poner código] | Un elemento de afiliación a la educación individual |
/ email / [poner código] | Una dirección de correo electrónico individual asociada con el registro. |
/ empleo / [poner código] | Un elemento de afiliación laboral individual |
/ identificador-externo / [poner código] | Un identificador externo vinculado individual en otro sistema |
/ financiación / [poner código] | Una actividad de financiación individual |
/ keywords / [poner código] | Una palabra clave individual relacionada con el investigador y su trabajo. |
/ otros-nombres / [poner código] | Un nombre adicional individual por el cual se conoce al investigador. |
/ peer-review / [poner código] | Una actividad individual de revisión por pares |
/ investigador-urls / [poner código] | Un enlace externo individual a la página personal o de perfil del investigador. |
/ trabajo / [poner código] | Un trabajo de investigación individual |
/ works / [poner código1], [poner código2], [poner código3] | Trabajos de investigación individuales a granel (hasta 100) |
Usando el punto final de la sección y el código de colocación, puede llamar a la API usando su mismo token de acceso para obtener ese elemento específico en su totalidad. Esta llamada de ejemplo recupera el elemento de financiación completo 4413 en formato XML utilizando la API de miembro en el servidor de espacio aislado.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
La API devolverá un mensaje 200 OK para indicar que el mensaje se recibió correctamente y devolverá el XML completo del elemento de financiación:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
Puede comprobar el fuente de un artículo al leerlo si quieres saber quién lo agregó.
ORCID los miembros pueden actualizar la información que han agregado previamente a un ORCID registro. Solo se puede actualizar un elemento a la vez, y solo se puede actualizar con las credenciales del cliente que lo creó en primer lugar.
Para facilitar la actualización, asegúrese de almacenar el código de acceso y el token de acceso al crear elementos.
Dar formato al elemento actualizado in ORCID esquema de mensaje con la información modificada e incluir la almacenada poner código.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
Llame a la API:
Method: PUT Content-type: application/vnd.orcid+xml or application/vnd.orcid+jsonnAuthorization type and Access token: Bearer [stored access token]Data: link to file or text of affiliation to update URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
La API devolverá un mensaje 200 OK para indicar que el artículo se actualizó correctamente. Consulte nuestra página de solución de problemas si se devuelve un mensaje diferente.
Una lista de códigos de error de API comunes, sus posibles significados y consejos sobre cómo solucionarlos está disponible en nuestro de documentación técnica.
Si no puede resolver el problema que está experimentando, háganoslo saber.
La visibilidad indica la configuración de privacidad del elemento, según la preferencia de visibilidad establecida por el usuario. Si se incluye una etiqueta de visibilidad cuando se publica información a través de la API, se ignorará. Por el contrario, la información se publicará según la preferencia de visibilidad predeterminada del usuario según lo establecido en las preferencias de su cuenta.
Cualquiera puede leer los elementos públicos a través de la API y se muestran en el registro público del investigador. Los elementos de partes de confianza solo se devuelven a través de la API a los clientes que tienen acceso de lectura limitado; no están en el registro público del investigador. Los elementos privados son visibles solo para el investigador y la fuente del elemento; los únicos elementos privados devueltos a través de la API son aquellos que se agregaron al registro a través de su integración. Más sobre la configuración de visibilidad en el ORCID Registro.
Los elementos (trabajos, empleo, financiación, revisión por pares, etc.) se pueden agregar a un ORCID grabar usando el ORCID API miembro. Para hacer esto, primero debes obtener permiso del investigador usando OAuth y formatear los metadatos del elemento usando el ORCID esquema de mensaje.
Una vez que haya formateado los datos y recopilado el ORCID iD y token de acceso, realiza una solicitud de API mediante HTTP POST, especificando el punto final relevante.
Method: POST
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]data: link to file or text of single employment item to add
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment
La llamada a continuación agrega un nuevo empleo afiliación a un registro en el servidor de pruebas sandbox:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
La API devolverá un mensaje 201 para indicar que el elemento se publicó correctamente, junto con el elemento poner código. Su cliente aparecerá como el fuente del artículo.
Consulta nuestras la solución de problemas página si se devuelve un mensaje diferente. Necesitará guardar el almacenar el código de acceso y el token de acceso para realizar actualizaciones o eliminar el elemento.
La acreditación ORCID La API de búsqueda utiliza la sintaxis SOLR. Se admiten todas las sintaxis de consulta disponibles en SOLR 3.6, incluido Lucene con extensiones Solr (Por defecto), DisMax y Dismax extendido.
Necesita un token de acceso "/ read-public" para usarlo. Una vez que haya obtenido su token de búsqueda, cree su URL de búsqueda base:
Tipo de credenciales: | Public API | API de miembros |
URL del recurso: | Zona de pruebas: https://pub.sandbox.orcid.org Producción: https://pub.orcid.org | Zona de pruebas: https://api.sandbox.orcid.org Producción: https://api.orcid.org |
Versión de API: | v3.0 | |
Punto final de búsqueda | / search /? = [consulta] |
Un ejemplo de llamada para buscar “orcid” con el token en la API pública de sandbox con los resultados devueltos en formato XML es:
Method: GET Content-type: application/vnd.orcid+xmlnAuthorization type and Access token: Bearer [stored access token]URL: https://pub.sandbox.orcid.org/v3.0/search/?q=orcid
Los resultados especificarán el número de resultados encontrados (número encontrado) y mostrarán los primeros 1000 resultados de forma predeterminada:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:search num-found="385" xmlns:search="https://www.orcid.org/ns/search" xmlns:common="https://www.orcid.org/ns/common">
<search:result>
<common:orcid-identifier>
<common:uri>https://sandbox.orcid.org/0000-0001-2345-6789</common:uri>
<common:path>/0000-0001-2345-6789</common:path>
<common:host>sandbox.orcid.org</common:host>
</common:orcid-identifier>
</search:result>
[...]
</search:search>
Un ejemplo de búsqueda básica en la API pública de la zona de pruebas con resultados devueltos en formato json:
Method: GET
Content-type: application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.sandbox.orcid.org/v3.0/search/?q=newman
La búsqueda devuelve solo el individuo ORCID ID de registros que contienen datos públicos que coinciden con la búsqueda. Para obtener más información sobre el resultado, haga una llamada para leer el ORCID grabar directamente.
Para más información, visite nuestras Tutorial de la API de búsqueda.
Si ha agregado datos que deben eliminarse, por ejemplo, si se han asociado con el ORCID iD, entonces puede realizar una solicitud HTTP DELETE especificando el punto final relevante, junto con la ORCID identificación, token de acceso almacenado y código put almacenado. Solo se puede eliminar un elemento a la vez, y solo puede eliminar elementos agregados por su cliente. Puede eliminar elementos incluso cuando el usuario haya revocado el permiso.
Esta llamada de ejemplo elimina el elemento de empleo con el código de colocación "739288" de un registro "
Method: DELETE
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
En situaciones del mundo real, su sistema completa las interacciones API mediante un lenguaje de programación como PHP, Java o Ruby on Rails. Para practicar y probar, puede interactuar con el ORCID API que utilizan una variedad de herramientas capaces de realizar y recibir solicitudes HTTP. La mayoría de las herramientas HTTP de escritorio se ejecutan en la línea de comandos; para aquellos que prefieren una interfaz gráfica, las herramientas basadas en web son una alternativa útil.
VERIFICACIÓN XML / XSD
Hay muchas herramientas que verificarán su XML por usted; es una buena idea adoptar uno. Para muchas de las llamadas a la API, trabajará con información en formato XML. Particularmente cuando se trabaja con ORCID Mensaje de la API, será importante que el XML que utilice sea válido contra el XSD. (Ver nuestro documentación en GitHub para ORCID esquema de mensaje XSD.)
ORCID SERVIDOR DE PRUEBAS DE SANDBOX
La acreditación servidor de pruebas sandbox es una copia del ORCID Software de registro y solo contiene datos de prueba. Fue diseñado para proporcionar un lugar para probar cosas sin afectar ningún ORCID iDs, especialmente si está trabajando con ORCID API y necesita un lugar para probar su trabajo. Puede crear cuentas de usuario y probar las llamadas a la API en la zona de pruebas sin tener que preocuparse por afectar los datos de producción o enviar correo no deseado accidentalmente a los investigadores.
Ni siquiera necesitas ser un ORCID member para probar la API de miembros en la zona de pruebas. Todos pueden solicitar las credenciales de la API de miembro de la zona de pruebas y probar todas las funciones disponibles para la API de miembro.
El sitio y las API no serán tan confiables como lo son para los servidores de producción. No ofrecemos garantías sobre los datos en la caja de arena; no están respaldados y pueden eliminarse. La caja de arena también puede contener algunas funciones experimentales que aún no están en los servidores de producción, por lo que puede probar cosas antes de que existan en el Registro. Más información sobre el servidor de pruebas sandbox o solicitar credenciales de cliente.
HERRAMIENTAS HTTP
Hay muchas herramientas disponibles para ejecutar solicitudes HTTP. Algunos usamos:
La acreditación ORCID La API de búsqueda utiliza la sintaxis SOLR. Se admiten todas las sintaxis de consulta disponibles en SOLR 3.6, incluido Lucene con extensiones Solr (Por defecto), DisMax y Dismax extendido.
Puede utilizar una búsqueda por campo cuando necesite buscar una sección específica del ORCID registro. La lista actual de campos reconocidos en la búsqueda de API, junto con sus elementos de estructura de registro correspondientes, son los siguientes:
Campo de búsqueda | Descripción |
Datos biograficos | |
nombres dados | El (los) nombre (s) proporcionado (s) del usuario. |
apellido | El (apellido) apellido del usuario. |
nombre-crédito | El "nombre publicado" en el ORCID interfaz de usuario, el nombre que normalmente aparece en las publicaciones del usuario |
otros nombres | Nombres alternativos que puedan haber aparecido en las publicaciones del usuario. |
La dirección de correo electrónico del usuario. | |
keyword | Cualquier palabra clave asociada con el usuario. |
referencia-id-externa | Identificadores de otros sistemas añadidos a los del usuario ORCID grabar utilizando la API. |
Datos de afiliaciones | |
nombre-de-organización-de-afiliación | El nombre de cualquier organización en un elemento de educación o empleo en el registro del usuario. |
ID-organización-grid | La acreditación ID DE GRID de cualquier organización en la sección de actividades del registro del usuario. Generalmente, esto se asociará con un elemento de educación o empleo. |
Ror-org-id | La acreditación ID de ROR de cualquier organización en la sección de actividades del registro del usuario. Generalmente, esto se asociará con un elemento de educación o empleo. |
Ringgold-org-id | La acreditación Identificación Ringgold* de cualquier organización en la sección de actividades del registro del usuario. Generalmente esto estará asociado con un elemento de educación o empleo. |
Datos de financiación | |
títulos-de-financiación | El título de cualquier artículo de financiación en el registro del usuario. |
id de org de fondo | La acreditación ID de registro de Crossref Funder de cualquier organización en la sección de actividades del registro de un usuario. Generalmente esto estará asociado con un elemento de financiamiento, pero también puede estar asociado con una afiliación. |
números de subvención | Número de concesión (identificador) de cualquier elemento de financiación en el registro del usuario. |
Datos de actividades de investigación | |
títulos de trabajo | Los títulos de cualquier trabajo en el registro del usuario. |
identificadores-de-objetos-digitales | Un identificador externo de trabajo con tipo doi |
hacer-yo | Un identificador externo de trabajo con tipo doi y la relación de identificador externo establecida en self |
[tipo de identificador externo] * | Un identificador externo de trabajo con el tipo dado |
[tipo de identificador externo] * - propio | Un identificador externo de trabajo con el tipo dado y la relación de identificador externo establecida en self |
[tipo de identificador externo] * - parte de | Un identificador externo de trabajo con el tipo dado y la relación de identificador externo establecida en parte de |
[tipo de identificador externo] * - versión de | Un identificador externo de trabajo con el tipo dado y la relación del identificador externo establecida en versión de * Para obtener una lista completa de identificadores externos, consulte la lista de identificadores. Algunos identificadores pueden requerir "-self", "-part-of" o "-version-of" para devolver resultados. |
ORCID registrar datos | |
orcido | El de 16 dígitos ORCID Identificador del usuario, en formato 0000-0001-2345-6789. |
fecha de envío de perfil | La fecha y hora en que se creó el registro. |
fecha-última-modificación-del-perfil | La fecha y hora en que se modificó por última vez el registro. |
Toda la información | |
texto | Todos los campos anteriores. Este también es el campo predeterminado para las consultas de sintaxis de Lucene. |
Vea las reseñas de nuestros Tutorial de la API de búsqueda para obtener más información.
*Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información
La URL para anular el registro de un webhook es la misma que para registrarse. Sin embargo, debe utilizar el método HTTP DELETE.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
HEADER: Authorization: Bearer [Your access token]
HEADER: Content-Length: 0
METHOD: DELETE
La respuesta debe ser 204 No Content
.
HTTP/1.1 204 No Content
Server: Apache-Coyote/1.1
Date: Fri, 05 Apr 2013 12:49:17 GMT
Los miembros premium pueden registrar webhooks contra cualquier ORCID inscripción en el registro. Los pasos son:
Codificar la URL
Codifique la URL que desee ORCID para llamar cuando se actualice el registro del usuario. Por ejemplo la siguiente URL:
https://nowhere2.com/0000-0002-7465-2162/updated
se convierte en
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Construye la URL
Cree la URL completa para ORCID Llamada a la API que comienza con la URL del ORCID registre y luego agregue ‚√∫/webhook‚√π y la URL que desea llamar. Debería verse así: https://api.sandbox.orcid.org/{ORCID} / webhook / {URL-ENCODED-WEBHOOK-URL}
Por ejemplo, utilizando la URL de webhook anterior y la ORCID iD 0000-0002-7465-2162, la URL completa es:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Registrar el webhook
Use su token de acceso de webhooks para registrar su webhook contra el del usuario ORCID registro. Debe utilizar una solicitud HTTP PUT, pero no debe incluir nada en el cuerpo de la solicitud.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdatedn HEADER: Accept: application/json HEADER: Authorization: Bearer [Your access token]n HEADER: Content-Length: 0n METHOD: PUT
La respuesta debe ser 201, pero si la devolución de llamada ya existía, la respuesta será 204.
HTTP/1.1 201nServer: nginx/1.1.19nConnection: keep-alive Location: https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Frequestb.in%2Fz57lzcz5
La acreditación ORCID El registro realizará la siguiente llamada HTTP cuando se actualice un registro. La solicitud utiliza el método HTTP POST, pero el cuerpo de la solicitud está vacío.
curl -v -X POST https://nowhere2.com/0000-0002-7253-3645/updated
Su servidor debe responder con códigos de respuesta HTTP estándar. Por lo tanto, si la llamada se realizó correctamente, debe devolver 204 Sin contenido.
HTTP/1.1 204 No Content
Cualquier código de respuesta 2xx significa que la llamada se realizó correctamente. Si devuelve un código que no es 2xx, volveremos a intentar la llamada cinco minutos más tarde.
La acreditación ORCID el registro admite la "negociación de contenido". Esto significa que las máquinas y otros sistemas pueden solicitar ORCID registro de metadatos de personas en diferentes formatos.
Uno de estos formatos es JSON-LD, que utiliza la schema.org vocabulario, específicamente el tipo de persona, que conectamos con obras, organizaciones y otros identificadores. También admitimos XML, JSON, RDF XML y turtle, y hemos implementado el intercambio de recursos de origen cruzado (CORS) para que nuestros datos sean de fácil acceso.
- Ver este entrada de blog para obtener una descripción general de ORCID y schema.org
- Vea las reseñas de nuestros documentación técnica sobre negociación de contenido
En situaciones del mundo real, su sistema completa las interacciones API mediante un lenguaje de programación como PHP, Java o Ruby on Rails. Sin embargo, para practicar y probar, puede interactuar con el ORCID API que utiliza una variedad de herramientas capaces de realizar y recibir solicitudes HTTP. La mayoría de las herramientas HTTP de escritorio (como cURL) se ejecutan en la línea de comandos; para aquellos que prefieren una interfaz gráfica, las herramientas basadas en web son una alternativa útil.
Una herramienta popular es Zona de juegos OAuth 2.0 de Google, una herramienta gratuita basada en la web desarrollada y mantenida por Google.
Consulte nuestro tutorial práctico sobre API en: https://info.orcid.org/hands-on-with-the-orcid-api/
Nota: ORCID no mantiene OAuth 2.0 Playground: esta herramienta fue creada por Google, quien mantiene su código exclusivamente. Si bien actualizamos esta documentación periódicamente, es posible que haya algunas imprecisiones de vez en cuando, ya que es posible que no tengamos conocimiento inmediato de los cambios en OAuth 2.0 Playground.
El control del investigador es fundamental ORCID principio así que las direcciones de correo electrónico registradas y añadidas a la ORCID Los registros están, por defecto, configurados como solo visibles para el poseedor del registro. Los correos electrónicos no verificados no se muestran en la vista pública del registro y solo las direcciones de correo electrónico que se hayan verificado aparecerán en los resultados de la API.
Una vez que los investigadores han verificado su dirección de correo electrónico, deben optar por hacerla visible para todos (es decir, pública) o para las partes de confianza (es decir, acceso limitado) para que la dirección de correo electrónico sea leída por organizaciones de terceros.
Si el investigador ha establecido su dirección de correo electrónico en Partes de confianza, se le devolverá con el registro si el investigador le ha concedido acceso de lectura limitada. Para más información, consulte la ORCID configuración de visibilidad.
Para nuestra API versión 2.0 y superiores, los límites son:
- Solicita un segundo - 24
- Ráfaga - 40
Solicitar un segundo: número de solicitudes que se pueden realizar por segundo.
Ráfaga: número de solicitudes que permitiremos que se pongan en cola antes de rechazarlas. Las solicitudes en la cola se ralentizan a la velocidad de solicitudes por segundo. Si excede la ráfaga, obtendrá una respuesta 503.
Si tiene problemas con los límites, comuníquese con el líder del equipo de participación para obtener ayuda.
Consulte la ORCID página de sistemas habilitados por proveedores para editores para obtener la información más actualizada
API 3.0 es la versión de API predeterminada y le recomendamos que utilice esta versión cuando cree nuevas integraciones. Continuaremos admitiendo API 2.0 y 2.1 en el futuro previsible, y avisaremos con al menos 12 meses de antelación antes de desactivar esas versiones.
Aprendimos mucho durante la transición de API 1.2 a API 2. Esta vez hemos hecho que la actualización sea mucho más fácil de administrar. API 3.0 agrega nueva funcionalidad y solo modifica la funcionalidad existente cuando es absolutamente necesario. Esto significa que los integradores deberían poder cambiar a la nueva API con un mínimo de esfuerzo. También significa que, aunque le recomendamos que comience a planificar su actualización lo antes posible para que su organización e investigadores puedan beneficiarse de las nuevas funciones, tiene mucha flexibilidad para decidir cuándo actualizar a 3.0.
La pequeña lista de cambios potencialmente importantes se encuentra en las notas de la versión de nuestra API aquí y aquí. Hay algunos cambios en los campos opcionales / obligatorios, las enumeraciones JSON se han modificado ligeramente y también tenemos una pequeña refactorización de nuestros esquemas XML, agregando algunos campos nuevos para contener los metadatos requeridos para la nueva funcionalidad.
¡Sí! Puede leer más sobre el control de versiones de nuestra API, la razón fundamental detrás de él y más, aquí en nuestro Política de versión de API.
Cualquier miembro premium puede obtener un token de acceso '/webhook'. Se puede usar un solo token para registrar webhooks para varios registros. Para obtener un token, realiza una llamada al ORCID Punto final del token de API.
Este proceso a menudo se denomina flujo de OAuth de credenciales de cliente u OAuth de 2 pasos.
A continuación se muestra un ejemplo de llamada para obtener el token de acceso: reemplace los marcadores de posición con sus credenciales (asegúrese de eliminar los corchetes).
curl -i -L -H "Accept: application/json"
-d "client_id=(your client ID)"
-d "client_secret=(your client secret)"
-d "scope=/webhook"
-d "grant_type=client_credentials"
"https://sandbox.orcid.org/oauth/token"
A continuación, se le devolverá un token de acceso similar al siguiente.
{"access_token":"5eb23750-1e19-47a3-b6f6-26635c34e8ee",
"token_type":"bearer",
"refresh_token":"c7d3d5fd-e4c0-4825-89f2-7cfb4a1cf01e",
"expires_in":631138518,
"scope":"/webhook"}
Esta sección muestra cuántas autenticaciones están procesando sus integraciones
Usuarios únicos mensuales de OAuth
Número de usuarios en horas extras que se conectaron a su(s) integración(es) a través de OAuth. Tenga en cuenta que estos datos son una muestra, lo que significa que los números proporcionados se estiman mediante la extrapolación de un subconjunto de la actividad del usuario.
Esta sección muestra cuántos ORCID los registros están conectados a su (s) dominio (s) de correo electrónico
ID con dominio (s) de correo electrónico:
Una métrica que cuenta el número total de iD que tienen una dirección de correo electrónico que termina en uno de los dominios registrados. Si desea agregar dominios adicionales, háganoslo saber.
Correos electrónicos con dominio (s) a lo largo del tiempo:
Un gráfico que muestra el uso de dominios registrados a lo largo del tiempo. Los investigadores pueden haber registrado más de una dirección de correo electrónico, y este gráfico cuenta todas las direcciones de los investigadores.
Distribución de dominio:
Un gráfico que muestra el desglose de los dominios de correo electrónico que coinciden con los dominios registrados. Por ejemplo, si example.com está registrado, esto mostrará la división entre "apple.example.com" y "banana.example.com"
Tenga en cuenta que los dominios de correo electrónico no son una fuente confiable de datos para el número de investigadores de su organización. Muchos investigadores utilizan servicios de correo web genéricos.
A medida que continuamos desarrollando nuestros productos, hay una serie de funciones que solo están disponibles con API 3.0, que es nuestra última versión de API predeterminada.
La siguiente tabla proporciona una breve descripción de cada función. Si tiene alguna pregunta sobre alguna de las funciones o la actualización a 3.0, comuníquese con su Líder de participación o su Líder de consorcios.
Capacidad para leer y escribir todos los tipos de afiliación (membresía, servicio, puestos invitados, distinciones y calificaciones no están disponibles con versiones anteriores de la API) |
Capacidad para leer y escribir recursos de investigación. |
Capacidad para leer y escribir identificadores de trabajo con el tipo de relación 'Financiado por'. Se utiliza para vincular los ID de subvención o propuesta a los metadatos de trabajo. |
Capacidad para leer y escribir identificadores de trabajo con el tipo de relación 'Versión de'. Se utiliza para vincular otras versiones del trabajo. Un caso de uso de ejemplo sería vincular la preimpresión y el artículo publicado. |
Capacidad para leer y escribir roles CRediT dentro de metadatos de trabajos. |
Capacidad para leer los campos fuente adicionales común: id-cliente-origen-aserción y común: nombre-origen-aserción para afiliaciones agregadas por el ORCID portal de miembros y trabajos agregados por asistentes de búsqueda y enlace. |
Capacidad para leer y escribir obras con tipo de trabajo de: anotación planes-de-manejo-de-datos disertación-tesis preprint objeto físico una estrategia SEO para aparecer en las búsquedas de Google. |
Capacidad para leer y escribir identificaciones externas para afiliaciones. |
Los ID de organización son obligatorios para agregar afiliaciones y financiamiento a ORCID Records. |
Formalización de identificadores: presentamos un nuevo campo generado por el sistema, que expresa identificadores externos (DOI, PMCID, PMID, ArXiv, Bibcode, ISSN e ISBN) en un formato normalizado con el fin de hacer coincidir y agrupar. La normalización se realiza en función de las reglas del tipo de identificador y puede incluir la configuración de todos los caracteres alfabéticos en minúsculas o la transformación de espacios, guiones, puntos y otros caracteres que pueden tratarse como equivalentes. También agrega prefijos y sufijos estándar según corresponda. Por ejemplo, https://doi.org/10.1/123, 10.1/123y https://dx.doi.org/10.1/123 todos aparecerán en este campo como https://doi.org/10.1/123. El valor del identificador existente no se modifica. |
Se puede encontrar información más detallada. aquí.
Lecturas de API: Número de llamadas API GET en horas extras que ha realizado su integración.
Eventos de inicio de sesión de integración mensuales (desde enero de 2024 en adelante): Número de inicios de sesión en tiempo extra que se han conectado a su integración a través de OAuth.
Buscando un usuario usando cURL así:
curl -iL https://orcid.org/0000-0000-0000-0000
Devolverá un 200 incluso si el usuario no existe. Para evitar esto, use la negociación de contenido en su llamada de la siguiente manera:
curl -iL -H 'Accept: application/xml' https://orcid.org/0000-0000-0000-0000
El proceso para obtener permiso para agregar o actualizar datos en la cuenta de un usuario ORCID registro utiliza OAuth, como se describe en nuestro Preguntas frecuentes sobre OAuth de 3 patas. Solamente ORCID los miembros pueden usar la API de miembros para solicitar permisos de actualización. En términos simples, funciona así:
- Su sistema local crea un enlace especial
- Cuando se hace clic, se envía al usuario a ORCID, inicia sesión y concede permiso
- ORCID envía al usuario de regreso a su sistema con un 'código de autorización'
- Su sistema intercambia ese código por un 'token de acceso'
- El token de acceso le permite actualizar el registro del usuario.
Integración ORCID en su sistema le permite a su organización recopilar datos autenticados ORCID ID y agréguelos a sus propios datos. Al mismo tiempo, el investigador otorga permiso a la organización para leer y escribir hacia y desde su ORCID registro.
Para que esto funcione, las organizaciones DEBE obtener autenticado ORCID identificaciones usando el ORCID API de OAuth. Esto significa que incluyen un ORCID botón o enlace de marca dentro de su sistema, que al hacer clic, solicita al usuario que inicie sesión en su ORCID registro.
Una vez registrado, se le pedirá al usuario que autorice el acceso al sistema solicitando su ORCID iD
Los usuarios ORCID iD y nombre en el ORCID El registro (según la configuración de visibilidad) se devuelve a la organización como parte de este proceso. El sistema puede entonces solicitar datos adicionales del ORCID API.
El flujo de trabajo descrito anteriormente para recopilar API autenticadas está disponible en ambos ORCIDAPI públicas y miembros de. El primero está disponible para su uso de forma gratuita por parte de servicios no comerciales.
Puede ayudar a facilitar la vida de sus usuarios conectando información validada a sus ORCID registros. También ayudará a generar confianza en las comunicaciones académicas y, al mantener esos datos actualizados, puede reducir la carga de informes para sus usuarios y mejorar la calidad de los datos.
ORCID para organizaciones de investigación
Además de su uso como identificador persistente para sus investigadores, ORCID puede ayudarlo a controlar cómo se usa el nombre de su institución en los sistemas de investigación. En combinación con otros identificadores persistentes ORCID le permite afirmar con autoridad las afiliaciones de su personal, profesores y estudiantes con su institución. También puedes usar ORCID API para recibir notificaciones en tiempo real sobre actividades de investigación, actualizar formularios automáticamente y seguir las carreras de sus alumnos.
ORCID para Organizaciones Financiadoras
Incrustando ORCID iDs en sus flujos de trabajo de financiamiento, puede conectar de manera confiable a sus beneficiarios y programas de financiamiento, y ahorrar tiempo a todos y reducir los errores causados por la introducción manual de información. Utilizando ORCID en su (s) sistema (s), puede desempeñar su papel en la construcción de una infraestructura de información de investigación confiable al afirmar las conexiones entre las personas y las subvenciones que les otorga.
ORCID para editores
Los investigadores están en el centro de todo lo que hacen los editores académicos y de investigación. La información precisa del autor y el revisor es vital para la indexación, la búsqueda y el descubrimiento, el seguimiento de publicaciones, la atribución del uso de recursos y financiación, y el apoyo a la revisión por pares.
ORCID sirve como un centro de información, lo que permite a sus autores y revisores conectarse de manera confiable a sus contribuciones y compartir información de sus ORCID registro a medida que interactúan con sus sistemas de publicación. La recopilación de iD para todos sus autores y revisores durante el proceso de publicación, ya sea para libros, revistas, conjuntos de datos, composiciones, presentaciones, código o una variedad de otros trabajos, permite que la información se comparta fácilmente, garantiza que los investigadores puedan dar su consentimiento para compartir, ahorra tiempo y molestias a los investigadores, reduce el riesgo de errores y, lo que es más importante, permite que los investigadores obtengan el crédito que merecen por el importante trabajo que están realizando.
ORCID se esfuerza por permitir conexiones transparentes y confiables entre los investigadores, sus contribuciones y sus afiliaciones al proporcionar un identificador único y persistente para que las personas lo utilicen mientras participan en actividades de investigación, becas e innovación. Garantizar que la correcta ORCID iD está asociado con el investigador adecuado es un paso crítico en la construcción de la confiabilidad del ORCID conjunto de datos y el ecosistema más amplio de comunicaciones académicas. Por esta razón, ORCID no permite la recogida o entrada manual de ORCID ID en cualquier flujo de trabajo donde sea posible recopilar ORCID Identificaciones directamente de los propios titulares de registros.
Los investigadores pueden compartir de forma fácil y segura sus ORCID identifica con los sistemas con los que interactúan, lo que demuestra que son dueños de su ORCID identificación. Luego, esos sistemas pueden compartir información sobre las actividades de los investigadores con otros sistemas, lo que crea una cadena de afirmaciones validadas y confiables sobre la actividad de los investigadores. El resultado final es que la persona correcta está asociada con las actividades correctas en una amplia gama de flujos de trabajo de información académica.
Para más información, ver: https://info.orcid.org/collecting-and-sharing-orcid-ids/
Además de tener acceso a la API para miembros, también se beneficia de:
- Soporte técnico y de comunicaciones de ORCID personal, que tiene su sede en 14 países de todo el mundo y que en conjunto hablan 13 idiomas
- Estar en la lista como la fuente de información que agrega ORCID archivos
- Recibir informes periódicos sobre el uso de su ORCID integración (mensual para miembros premium, dos veces al año para miembros básicos)
- Recibiendo una advertencia anticipada de ORCID noticias, actualizaciones y eventos a través de nuestro boletín mensual para miembros
- Poder nominar a alguien de su organización para que represente ORCID Junta y votación en nuestras elecciones anuales de Junta
ORCID la membresía le permite hacer más que simplemente recolectar ORCID iDs. Le da derecho a acceder al ORCID API miembro, lo que significa que puede conectar información a sus autores y revisores. ORCID registros, y puede leer la información en sus registros que han etiquetado como Partes de confianza (ORCID miembros), así como su información disponible públicamente.
Cualquier revista u organización puede recopilar iD sin unirse ORCID, utilizando nuestra API pública. ORCID La membresía requiere que su revista pague una cuota anual de membresía.
Por favor, complete este formulario o ponte en contacto con nosotros en [email protected]. [email protected]
Puede comprobar nuestra lista de miembros¬¨‚
Su revista no será miembro en el sentido de que pueda obtener soporte técnico directo o representar la ORCID Junta / voto en las elecciones de la Junta. Pero, según el tipo de membresía que tenga su editor o institución, es posible que tenga acceso a otros beneficios para miembros, como el uso de la API para miembros.
Sí, nuestras tarifas están disponibles en nuestro Página de membresía
Consulta nuestra Pautas para uso de la marca Boulder para exhibir ORCID en artículos de revistas.
Si (ver pregunta 10)
- La API pública está disponible para que todos la utilicen. Debe estar vinculado a un usuario individual ORCID iD y, si esa persona deja su organización, deberá configurar un nuevo conjunto de credenciales. Puede usar la API pública para recopilar datos autenticados ORCID iDs y para leer la información disponible públicamente en ORCID archivos
- La API de miembros solo está disponible para miembros. Además de recopilar ID autenticados y leer información disponible públicamente, también puede leer información marcada como Partes de confianza y conectar información a ORCID registros, por ejemplo, sobre sus autores‚ publicaciones. La membresía básica le da derecho a un conjunto de credenciales (una integración), mientras que la membresía premium le brinda hasta cinco conjuntos de credenciales (cinco integraciones)
ORCID La actualización automática permite a los autores tener su ORCID registros actualizados automáticamente. Funciona así:
- El editor recopila la información del autor. ORCID iD durante el proceso de publicación (generalmente durante el envío del manuscrito)
- El editor incluye el iD en los metadatos al registrar un DOI para la publicación
- El autor recibe un correo electrónico del registro DOI (actualmente Crossref) pidiendo permiso para actualizar su registro O el autor crea un perfil de DataCite y lo vincula a su ORCID grabar
- El autor concede permiso a Crossref o DataCite para actualizar su ORCID grabar (solo tienen que hacer esto una vez)
- Cada vez que Crossref o DataCite registran un DOI que incluye el del autor ORCID iD actualizan automáticamente su registro
Para más información, consulte la https://www.crossref.org/community/orcid/
sí. Para obtener más información, lea nuestro documentación
ORCID Las identificaciones son solo para individuos. Los editores interactúan con ORCID mediante la integración con nuestras API para recopilar iD, y para importar y exportar datos desde y hacia ORCID registros. Conozca más en nuestro publicación de documentación de flujos de trabajo
Los DOI son identificadores persistentes de objetos, más comúnmente para publicaciones de todo tipo (artículos de revistas, libros, capítulos de libros, conjuntos de datos, etc.). ORCID Los iD son identificadores persistentes para personas, y específicamente para personas involucradas en la comunidad de investigación, ya sea directamente como investigadores, autores o revisores, por ejemplo, o en roles de apoyo como bibliotecarios, editores, financiadores, etc.
ORCID se basa en dos mecanismos para transferir datos personales en virtud del RGPD. Primero, ORCID obtiene el consentimiento de sus usuarios en el momento del registro para la transferencia de datos personales de la UE a EE. UU. Segundo, ORCID entra en las Cláusulas Contractuales Estándar (CEC) con las organizaciones miembros según sea necesario.
Sí, ORCID transfiere datos personales de la UE a los EE. UU. como parte de su infraestructura de red. El software de registro en vivo está alojado en servidores ubicados dentro de los EE. UU.
Sí, además de las salvaguardas discutidas anteriormente, ORCID incorpora las siguientes medidas complementarias para abordar la protección de datos.
Control del sujeto de datos. Los usuarios cuentan con una gran cantidad de transparencia y control relacionados con la información compartida con ORCID y otros usuarios u organizaciones miembros. ORCID ha tomado medidas para minimizar la cantidad de datos personales necesarios para establecer una ORCID registro, que solo requiere un nombre y una dirección de correo electrónico. Además, ORCID deja en claro que sus herramientas y servicios brindan a los usuarios control sobre el registro, lo que está conectado a un iD y quién puede acceder a la información del usuario.
Acuerdos de procesador de terceros. ORCID celebra acuerdos con sus procesadores que incorporan disposiciones de seguridad y privacidad de los datos. Antes de celebrar acuerdos con procesadores, ORCID lleva a cabo la debida diligencia que aborda los componentes de privacidad y seguridad. Para llevar a cabo esta diligencia debida, ORCID primero determina si el proveedor externo tendrá acceso y / o recibirá copias de los Datos personales. Si la respuesta es sí, entonces ORCID avanza en la negociación de un acuerdo de procesamiento de datos que se alinea con los requisitos del RGPD y cualquier otro requisito de protección de datos aplicable.
Cifrado de datos. ORCID implementa medidas de cifrado razonables para todos los datos en reposo y en tránsito. Además, todas las copias de seguridad están encriptadas.¬¨‚
Medidas técnicas y organizativas. ORCID implementa una variedad de controles de seguridad para respaldar la administración segura de sus bases de datos e infraestructura. Estos controles de seguridad incluyen la administración de parches de seguridad; monitoreo de acceso al sistema; registro de auditoría; control de acceso; y mecanismos de control de cambios. Adicionalmente, ORCID mantiene un plan de respuesta a incidentes, así como un proceso de recuperación de datos y desastres.
Sí, ORCID mantiene una serie de documentos en su sitio web relacionados con sus prácticas de privacidad y seguridad. Esos documentos incluyen:
- Política de privacidad - ORCID
- ORCID Confianza - ORCID
- ORCID, GDPR y tus derechos como usuario ‚ORCID
Carta de declaración de TRUSTe (Microsoft Word - Carta de certificación de atestación_ORCID20191220.docx)
ORCID se complace en suscribir las Cláusulas Contractuales Estándar con cualquier miembro ubicado en la UE, EEE o Reino Unido que esté transfiriendo datos personales a ORCID utilizando la API miembro. Comuníquese con su ORCID Póngase en contacto con el equipo del encargo para analizar la incorporación de las Cláusulas contractuales estándar a su acuerdo de membresía.
No es probable que ORCID estaría sujeto a las solicitudes de la ley de vigilancia de EE. UU. destacadas en la decisión Schrems II. Desde ORCID no es un “proveedor de servicios de comunicaciones electrónicas” como se define en la Sección 50 USC § 1881 (b) (4), no está sujeto a la Ley de Servicios de Inteligencia Extranjera (“FISA”). ORCID proporciona un registro en línea que se utiliza para identificar a los investigadores de las organizaciones miembros; como tal, la Sección 702 de FISA no se aplicaría a ORCID y sus datos.
Sí, ORCID deja en claro a los usuarios que, en caso de que reciba alguna solicitud de datos del gobierno, proporcionará "solo los datos que consideremos necesarios en la situación". Ver Política de privacidad, Sec. 6.4. Más ORCID deja en claro que, si se permite, "proporcionará rápidamente información sobre las solicitudes de datos gubernamentales recibidas y las cuentas afectadas a los titulares de registros pertinentes". Identificación.
Sí, ORCID no distingue entre usuarios ubicados en la UE o fuera de la UE. ¬¨‚ Si bien ciertas regiones pueden tener diferentes leyes de privacidad, ORCID se esfuerza por brindar protección de privacidad a todos los usuarios de acuerdo con su Política de privacidad, ubicada en https://info.orcid.org/privacy-policy/.
Si. Cualquiera que participe en investigación, becas o innovación puede registrar un ORCID iD por sí mismos de forma gratuita, y puede utilizar el mismo iD a lo largo de toda su carrera, incluso si su nombre cambia o se muda a una organización, disciplina o país diferente.
Ve a nuestro ¿Olvidó su contraseña? página, seleccione la Contraseña opción, ingrese su dirección de correo electrónico registrada en el campo de correo electrónico y seleccione la opción Recuperar detalles de la cuenta botón. Le enviaremos un correo electrónico con los pasos para restablecer su contraseña.*
*Si no hay ORCID iD asociado con la dirección de correo electrónico que ingresó, el correo electrónico que reciba de nosotros se lo informará. En ese momento, puede intentar restablecer su contraseña utilizando otra de las direcciones de correo electrónico (pruebe tanto personal como profesional). Consulte nuestro artículo sobre contraseñas olvidadas para obtener más información.
ORCID los identificadores que terminan en X son válidos y correctos.
ORCID todos los identificadores se asignan al azar y no se pueden cambiar. El último personaje de una ORCID identificador es una suma de comprobación. Tiene un rango de valores de "0" a "10", donde X representa el valor "10". La suma de comprobación garantiza que los otros 15 dígitos de su identificador formen un iD coherente.
Puede obtener más información leyendo sobre la estructura de un ORCID identificador.
Ve a nuestro ¿Olvidó su contraseña? página, seleccione la ORCID iD opción, ingrese su dirección de correo electrónico registrada en el campo de correo electrónico y seleccione la opción Recuperar detalles de la cuenta del botón.
Te enviaremos un correo electrónico desde [email protected], haciéndole saber sus 16 dígitos ORCID identificador. Por favor mira Yo olvidé mi ORCID iD, ¿cómo lo recupero? para obtener más información.
Si recuerda su contraseña, intente iniciar sesión en https://orcid.org/signin usando sus 16 dígitos ORCID iD o su dirección de correo electrónico anterior como su nombre de usuario.
Si ha olvidado su contraseña Y ha perdido el acceso al correo electrónico registrado anteriormente, por favor póngase en contacto con nosotros e incluyen:
- Nombre completo
- ORCID iD (s) que cree que pueden pertenecerle
- Cualquier dirección de correo electrónico anterior con la que se haya registrado
- Una dirección de correo electrónico institucional o laboral actual (si es posible)
Esta información nos facilitará la identificación de posibles ORCID registros que pueden pertenecerle y proporcionarle una respuesta más rápida.
Por favor mira ¿Cómo puedo acceder a mi ORCID registrar si ya no tengo el correo electrónico asociado para más información. Nota: para evitar que esto suceda en el futuro, recomendamos agregar varias direcciones de correo electrónico para usted ORCID cuenta.
Si no recibe ningún correo electrónico en 10 minutos, puede significar una de estas tres cosas:
- Nuestro correo electrónico se dirigió a su carpeta de correo no deseado o basura. Revise su carpeta de correo no deseado o correo no deseado para ver si ORCID.
- La dirección de correo electrónico ingresada contiene un error tipográfico. Inténtalo de nuevo.
- Su administrador de correo puede tener nuestros mensajes bloqueados. Comuníquese con nosotros si cree que este es el caso.
El problema más común que escuchamos de los usuarios es la pérdida de acceso a sus direcciones de correo electrónico anteriores registradas en sus cuentas.
Recomendamos encarecidamente agregar al menos una dirección de correo electrónico de respaldo, para que pueda recuperar el acceso a su ORCID grabar en caso de que pierda el acceso a otro correo electrónico.
Si ha olvidado qué dirección de correo electrónico registró su ORCID cuenta con, vaya a nuestro ¿Olvidó su contraseña? . Seleccione el boton ORCID iD y luego ingrese las direcciones de correo electrónico con las que se haya registrado.
Le enviaremos un correo electrónico para informarle su número de 16 dígitos. ORCID identificador.
Si el correo electrónico dice que no pudimos encontrar un ORCID iD asociado con la dirección de correo electrónico, luego vuelva a intentar el proceso anterior con sus otras direcciones de correo electrónico actuales (tanto personales como profesionales) para recuperar el ORCID identificación.
Cuando haya agotado todas las demás opciones, comuníquese con nosotros con su nombre completo, su ORCID identificador y cualquier dirección de correo electrónico con la que se haya registrado para una cuenta. Nota: para evitar que esto suceda en el futuro, recomendamos agregar varias direcciones de correo electrónico para usted ORCID cuenta.
Puede eliminar rápida y fácilmente su registro duplicado yendo a su Configuración y seleccionando Eliminar registro duplicado. Luego se le pedirá que ingrese la dirección de correo electrónico o ORCID iD del registro duplicado, así como la contraseña.
Cuando se elimina el registro duplicado, la dirección de correo electrónico adjunta se agregará a su ORCID registro, y se eliminará toda la otra información del registro.
Para obtener más información, consulte eliminando su adicional o duplicado ORCID iD.
Si ya no tiene acceso a esa cuenta de correo electrónico y no recuerda la contraseña, comuníquese con nosotros con su nombre completo, su contraseña de 16 dígitos. ORCID identificador y cualquier dirección de correo electrónico con la que se haya registrado para una cuenta.
Reciben una notificación en su ORCID inbox. Siempre que haya un cambio en los datos de un ORCID registro, el usuario recibe una notificación con información básica sobre el cambio, incluido el nombre del cliente que realiza la actualización, la fecha del cambio y el elemento en el ORCID registro que se actualizó. Ver nuestro Base de conocimientos del usuario para obtener más información sobre las notificaciones..
ORCID Los registros en la caja de arena también tienen bandejas de entrada en funcionamiento. Recomendamos revisar regularmente las bandejas de entrada de sus pruebas. ORCID registros al planificar cómo sus sistemas programarán actualizaciones de datos.
ORCID tiene el compromiso de ser abierto y transparente. Esto significa nuestro hoja de ruta del producto está disponible para que cualquiera pueda verlo, al igual que el trabajo actualmente en desarrollo.
La hoja de ruta del producto es fundamental para ORCID proceso de desarrollo de productos. Los requisitos viajan desde los tableros trello administrados por el equipo, a través del tablero trello Product Roadmap y en adelante al tablero trello Current Development, donde se implementan y se trasladan a nuestros sistemas de producción.
Esta placa contiene requisitos bien definidos que están programados para su implementación. en algún momentoy una lista de requisitos priorizados programados para su implementación a corto plazo.
¿De dónde vienen los requisitos?
Los requisitos se recopilan de muchas fuentes por ORCID personal. Pueden originarse a partir de solicitudes de miembros, comentarios del consorcio, pruebas de usuarios, proyectos estratégicos e informes de errores, entre otros. Además, todos ORCID Los equipos generan sus propios requisitos internos, como cambios en el sitio web, actualizaciones de infraestructura y actualizaciones de sistemas operativos. Cada tarjeta está etiquetada con el equipo que produjo el requisito: comunicaciones, estrategia, tecnología, participación u operaciones.
¿Cómo van las cosas en la hoja de ruta?
ORCID tiene como objetivo un ciclo de desarrollo de productos equilibrado y tiene reuniones periódicas entre equipos para discutir las prioridades a corto y largo plazo. Hacemos todo lo posible para abordar los errores, las nuevas funciones, la deuda técnica, las actualizaciones del sitio web y los elementos estratégicos por igual.
¿Cómo puedo contribuir a la hoja de ruta?
Agradecemos sugerencias sobre cómo mejorar el ORCID registro. Envíe sus comentarios a nuestro equipo.
Además, ORCID es un proyecto de código abierto y agradecemos las contribuciones a nuestro código fuente, así como a todos nuestros repositorios.
Las actualizaciones y otros anuncios para los usuarios de la API se comparten a través del ORCID Grupo de usuarios de API. También puede suscribirse a mensajes generales y actualizaciones a través del ORCID Blog.
ORCID los miembros también reciben el ORCID Boletín para miembros donde se incluye esta información. Finalmente, el contacto técnico para cualquier ORCID Los miembros con una integración activa y personalizada también recibirán mensajes de correo electrónico sobre actualizaciones críticas del ORCID Registro. Si desea aparecer como contacto técnico de su organización, por favor póngase en contacto con nosotros.
El boletín para miembros enviado mensualmente desde ORCID anteriormente contenía un enlace a una carpeta de Google Drive donde se almacenaban todos sus informes de miembros. Esto ahora se ha reemplazado con nuevos informes disponibles para todos los miembros en el portal de miembros.
Informes anteriores:
- Miembros premium con integraciones activas reciba un enlace único a una carpeta que contiene informes personalizados separados con datos para cada integración en el mes anterior.
- Miembros premium que aún no tienen una integración activa recibir un enlace único a una carpeta que contiene informes personalizados con estadísticas de correo electrónico para su institución, así como un enlace a una carpeta que contiene informes generales con datos agregados para todas las integraciones de miembros activos.
- Miembros basicos recibir un enlace a una carpeta que contiene informes generales emitidos dos veces al año con datos agregados para todas las integraciones de miembros activos en el semestre anterior; el informe del primer semestre del año se emite en Julio (Datos de enero a junio), el informe de la segunda mitad del año emitido en Enero (Julio-diciembre del año siguiente).
Si usted es un ORCID miembro y actualmente no recibe el boletín mensual para miembros, comuníquese con [email protected]
Miembros premium con integraciones activas
La carpeta de Google Drive contiene un informe de miembro para cada uno de los ID de cliente de producción que se le han enviado. Los nombres de los archivos incluyen el nombre para mostrar del cliente. iD y la fecha del informe; ordene por fecha de modificación para encontrar el informe más reciente. También hay una carpeta raw_data que contiene los datos utilizados para generar el informe, que está disponible para análisis adicionales si es necesario.
Miembros premium que aún no tienen una integración activa
La carpeta de Google Drive contiene un informe de miembros con datos de estadísticas de correo electrónico únicamente, así como un enlace a una carpeta de Google Drive de informes mensuales generales con datos agregados para todas las integraciones de miembros activos, para el año actual y anteriores. Los datos brutos no están disponibles para estos informes.
Recuentos de dominios de correo electrónico
Esta sección proporciona recuentos de ORCID iDs registró actualmente los dominios de correo electrónico de su institución en todos los períodos de tiempo. Para generar estos recuentos, buscamos dominios que coincidan con la URL del sitio web que tenemos archivada para su organización (por ejemplo, si la URL de su sitio web es www.universitycollege.edu, buscamos los correos electrónicos que terminan en @universitycollege). Si no tenemos registrada la URL de un sitio web, verá ‚√∫No se proporcionaron dominios de correo electrónico‚√π en esta sección. Si no conseguimos su dominio de correo electrónico del todo bien, o si desea agregar dominios adicionales, por favor póngase en contacto con nosotros.
- Registros registrados en sus dominios de correo electrónico¬¨‚Recuento de únicos ORCID iDs que incluyen una dirección dentro de los dominios de correo electrónico de su institución
- Registros registrados en sus dominios de correo electrónico Y asociados con su ID de cliente¬¨‚Recuento de únicos ORCID iD que incluyen una dirección dentro de los dominios de correo electrónico de su institución Y que incluyen a su institución como Parte de confianza (es decir, registros para los que su institución tiene un token de acceso válido)
Registros creados y reclamados
(Nota: la mayoría de los clientes no tendrán esta sección en sus informes)
Si tiene un cliente institucional que se utilizó para crear registros en nombre de los investigadores a través de la API, recibirá una sección llamada Estadísticas de registro. Esto incluye información sobre la cantidad de registros que creó y cuántos se han reclamado (el archivo raw_data contiene más información sobre los registros específicos utilizados para generar estos números).
Usuarios
Esta sección del informe contiene un recuento total de la cantidad de investigadores que utilizaron su integración para conectar sus ORCID iD a su sistema durante el mes de generación de informes. Además, da el número total de investigadores que se inscribieron en un nuevo ORCID iD como parte de la iD proceso de conexión.
El gráfico denominado Total de eventos de integración muestra el número de investigadores que utilizaron su integración durante el último mes, por día.
Eventos
El informe también contiene eventos información, las acciones que el investigador realizó al conectar sus ORCID grabar con su sistema en el mes de presentación de informes. Cada evento representa cualquier acceso otorgado por el usuario o acción que realizó en el ORCID sitio (como iniciar sesión o dar acceso de lectura limitado). La mayoría de los investigadores tendrán más de un evento asociado.
Si un evento tiene un ‚√∫√π adjunto, esto significa que el investigador otorgó una larga vida (Ppersistente), en comparación con un token de corta duración que caduca en una hora. Desde marzo de 2018, solo se admiten tokens de larga duración en el ORCID Registro; su sistema integrado o el usuario puede optar por revocar el token en cualquier momento.
Usuarios por país
La última sección de los informes contiene información sobre los investigadores que han utilizado su integración, desglosada por el país desde el que han accedido a ella. Estos datos se derivan de la dirección IP del investigador o de su ID geográfico (determinado por Google a partir de la dirección IP del investigador).
Muestreo
Debido a que muchos investigadores utilizan ORCID Registro, no es factible ejecutar informes sobre el conjunto completo de datos del investigador. En cambio, los números proporcionados aquí se producen utilizando tendencias de un conjunto muestreado y no muestreado. Las secciones del informe derivadas de los datos de muestra se señalan con un asterisco, y el tamaño y el espacio de la muestra se especifican en la pestaña Datos de análisis. Es posible que los números en la sección de Google Analytics del informe no coincidan por completo con las estadísticas locales que mantiene, y puede haber pequeñas discrepancias en el recuento entre las secciones del informe.
Los parámetros de muestreo enumerados debajo de Integration Analytics se aplican a todas las secciones marcadas con un asterisco. El porcentaje de sesiones capturadas por los datos analíticos es (tamaño de muestra) / (espacio de muestra) * 100%. Puede encontrar más información sobre el muestreo en Google Desarrolladores.
Informes vacíos
Las secciones Usuarios y Eventos del informe solo incluyen datos del mes anterior. Si ningún investigador ha utilizado su integración en el último mes, no se devolverán datos.
Preguntas
Si tiene alguna pregunta sobre sus informes de miembros, póngase en contacto con nosotros.
Una preimpresión es un manuscrito científico completo que los autores suben a un servidor público. La preimpresión contiene datos y metodologías completas; a menudo es el mismo manuscrito que se envía a una revista. Después de una breve inspección de control de calidad para asegurar que el trabajo es de naturaleza científica, el manuscrito del autor se publica en aproximadamente un día en la Web sin revisión por pares y puede ser visto sin cargo por cualquier persona en el mundo. En función de los comentarios y/o nuevos datos, se pueden enviar nuevas versiones de su versión preliminar; sin embargo, también se conservan las versiones preliminares anteriores. Los servidores de preimpresión permiten a los científicos controlar directamente la difusión de su trabajo a la comunidad científica mundial. En la mayoría de los casos, el mismo trabajo publicado como preprint también se envía para revisión por pares en una revista. Así, los preprints (rápidos, pero no validados mediante revisión por pares) y la publicación en revistas (lenta, pero que proporciona validación mediante revisión por pares) funcionan en paralelo como un sistema de comunicación para la investigación científica.
Nota: Este contenido y video aparecieron originalmente en el Sitio web de ASAPBio ¡Gracias a ASAPBio por ponerlo a disposición bajo una licencia CC-BY!
El esquema eduPerson agregó el eduPersonaOrcid atributo en su Actualización de febrero de 2016.
Según el especificación eduPerson:
RFC4512 definition
( 1.3.6.1.4.1.5923.1.1.1.16
NAME 'eduPersonOrcid'
DESC 'ORCID researcher identifiers belonging to the principal'
EQUALITY caseIgnoreMatch
SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
Tenga en cuenta que el formato de este campo es el ORCID-representación URI preferida del iD, Es decir, https://orcid.org/0000-0001-5727-2427.
Más información sobre el formato del ORCID iD puede encontrarse en Estructura de la ORCID identificador.
La acreditación ORCID El registro está diseñado para que los usuarios proporcionen sus ID a las organizaciones que utilizan OAuth, lo que garantiza que la iD se recopila para cada investigador. Desanimamos a las organizaciones a agregar ORCID iDs a sus sistemas basados en una búsqueda de investigadores por nombre. Sin embargo, puede resultar útil averiguar cuántos investigadores de su organización ORCID iDs, que se pueden hacer a través de la API. A continuación se ofrecen sugerencias para realizar búsquedas por organización.
Para obtener una introducción a la búsqueda, cómo obtener un token de acceso, cómo comprender los resultados de la búsqueda y detalles de otros campos que se pueden buscar, consulte nuestro Tutorial de búsqueda de la API de registro
Búsqueda por nombre y DOI
Al verificar si una persona tiene un ORCID registro, recomendamos buscar tanto por su nombre como por el DOI de uno o más de sus trabajos recientes. Esto debería dar como resultado solo el registro del investigador que está buscando, y no los registros de nadie más que comparta el mismo nombre.
Un ejemplo de llamada para buscar todos los registros con el nombre "Laurel Haak" y el DOI 10.1087 / 20120404 o el DOI 10.6084 / M9.FIGSHARE.1115124:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search?q=family-name:Haak+AND+given-names:Laurel+AND+digital-object-ids:%2210.1087/20120404%22+OR+digital-object-ids:%2210.6084/M9.FIGSHARE.1115124’%22
Buscar por afiliación
Los campos de afiliación se pueden buscar utilizando el nombre de la afiliación o el ID de ROR o GRID exclusivo de la organización. (Puede encontrar el GRID ID de su organización en GRID o su ID ROR en el Registro ROR)
Buscar por nombre de la organización
Method: GET Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:"University+of+Johannesburg"
O para una coincidencia exacta
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:(%22Boston%20University%22)
Buscar por ID de GRID
Un ejemplo de llamada para buscar todos los registros con el ID de cuadrícula grid.5509.9 (Universidad de Tampere):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=grid-org-id:grid.5509.9
Buscar por ID de ROR
Un ejemplo de llamada para buscar todos los registros con el ID de ROR 04fa4r544 (ORCID):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=ror-org-id:"https://ror.org/04fa4r544"
Buscar por dominio de correo electrónico
Puede utilizar la API para buscar investigadores por dominio de correo electrónico. Tenga en cuenta que alrededor del 97% de las direcciones de correo electrónico en ORCID son privados y los registros con una dirección de correo electrónico privada o de acceso de confianza no se devolverán en esta búsqueda.
Un ejemplo de llamada para buscar todos los registros con una dirección de correo electrónico @orcid.org:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=email:*@orcid.org
Resultados de búsqueda devueltos en formato CSV
Los resultados de la búsqueda también se pueden devolver en formato CSV. Como parte de la llamada, puede especificar las columnas de salida de una lista de campos disponibles a continuación:
orcido
email
nombre de pila
apellido
nombres y apellidos
nombre-crédito
otro nombre
nombre-afiliación-institución-actual
nombre-de-afiliación-de-institución-pasada
Con sus credenciales, debe especificar que el encabezado sea 'texto / csv '. Como parte de la llamada de búsqueda, también debe agregar los campos que necesita en la salida a la consulta.
Buscando usando solo su navegador
También puede completar la búsqueda usando su navegador. La URL se construye de la misma manera, pero no es necesario utilizar ninguna credencial de API. Tenga en cuenta que esto solo se puede completar utilizando la API pública.
A continuación se muestra un ejemplo de llamada usando la API pública buscando por nombre de organización con el ORCID, nombres de pila, apellidos, nombre de afiliación de la institución actual y nombre de afiliación de la institución anterior como el resultado deseado.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:ORCID&fl=orcid,given-names,family-name,current-institution-affiliation-name,past-institution-affiliation-name
A continuación se muestra otro ejemplo de llamada utilizando la API pública que busca por diferentes variaciones del nombre de la organización.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")
Si cree que los datos que se muestran en su informe son inexactos, por favor póngase en contacto con nosotros con tantos detalles como sea posible y nuestro equipo de participación investigará.
ORCID fue fundada en el principio que los investigadores deben tener control sobre su información. Para honrar este principio tenemos una fuerte políticas de privacidad, que fue diseñado para tomar en cuenta las variaciones locales en las regulaciones de privacidad, y nos enfocamos en la perspectiva del investigador al desarrollar políticas y funcionalidades.
De acuerdo con nuestro principio fundamental del control del investigador, ORCID Los registros solo pueden ser creados por los propios investigadores, en el ORCID sitio web.
Como parte de su flujo de trabajo de integración, sus investigadores podrán registrarse para un nuevo ORCID iD o inicie sesión en su registro existente que le permite recopilar sus ORCID identificación. Por favor vea nuestro Tutoriales API para obtener más información.
Nos encantan los comentarios de nuestra comunidad, así que háganos saber si tiene algún comentario sobre los informes de los miembros poniéndose en contacto con nosotros en https://support.orcid.org/hc/en-us/requests/new
Si su organización es una ORCID miembro, entonces debe comunicarse con el ORCID contacto en su organización que podrá proporcionarle acceso a la ORCID Portal de miembros. Si no puede identificar sus organizaciones ORCID contacte a continuación, póngase en contacto con el líder del consorcio o con el representante del equipo de participación.
Los datos que se utilizan para producir los informes de miembros e integración se actualizan a diario.
Todas las secciones de afiliación utilizan el mismo conjunto de metadatos en la API:
- Nombre de la organización:* El nombre de la organización al más alto nivel (por ejemplo, "Boston University" en lugar de "Boston University School of Medicine").
- Ciudad de la organización: * Ciudad donde tiene su sede la organización.
- Región de la organización: Región donde se encuentra la organización.
- País de la organización * el país de la organización. Esto debe llenarse con el código de país ISO 3166 Alpha-2 de dos letras.
- Identificación de la organización (ROR, GRID, Ringgold** o LEI):* Un identificador único para la organización y su origen. Recomendamos que se utilice el ID de la organización principal dentro de la afiliación y no de la división o el departamento.
- Rol / Título: El cargo que ocupa, o el título otorgado o por otorgar.
- Departamento: Cualquier subdivisión de la organización matriz.
- URL: Una URL a un recurso sobre la afiliación.
- Fecha de inicio: La fecha en que comenzó la relación entre el investigador y la organización (se puede especificar por año, mes y día).
- Fecha de finalización: La fecha en que terminó la relación entre el investigador y la organización (se puede especificar hasta año, mes y día)
- Un identificador persistente externo que describe la afiliación: Un identificador único para la afirmación de afiliación real.
*Indica un campo obligatorio.
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
Hay una serie de secciones debajo de la biografía, parte de un ORCID grabar:
Tambien conocido como: Esto puede incluir un nombre abreviado, variantes que incluyen iniciales para uno o más nombres, segundo nombre, nombre anterior o alternativo o nombre en un conjunto de caracteres diferente. Cada nombre debe agregarse como un solo elemento. Este es un campo de texto libre de hasta 255 caracteres.
página web: Esta sección incluye una descripción (opcional) y una URL del sitio web (obligatorio).
Canton: La sección País de un ORCID El registro permite a los investigadores y las organizaciones miembros agregar uno o más países donde realizan investigaciones o que son el tema de su investigación. Los elementos de la lista de países se obtienen de ISO 3166, el estándar internacional para códigos de países y regiones.
Identificadores externos (otros ID): Esta sección solo puede ser agregada por organizaciones miembro. Tenga en cuenta que, aunque muchas organizaciones recopilan otros identificadores externos para sus investigadores, por ejemplo, ID de autor de Scopus, solo el emisor de esos identificadores puede afirmarlos con autoridad. Por lo tanto, recomendamos encarecidamente que su organización solo agregue los identificadores que su sistema creó y utiliza para identificar a los investigadores. Esta sección incluye cuatro componentes (* indica un campo obligatorio):
- Tipo de identificación*
- Valor de ID *
- Relación ID *
- URL de identificación
- Papel:* El papel de la persona en el proceso de revisión, que se puede seleccionar entre: presidente, editor, miembro, organizador, revisor
- Identificador de grupo: * El ID de grupo que se utiliza para fines de agregación: para los artículos de revistas, el identificador predeterminado es el eISSN, que se completa automáticamente mediante una integración con la base de datos ISSN. Tenga en cuenta que, si necesita asignar un identificador que no sea un ISSN, deberá créelo antes.
- Organización convocadora *: La organización que organizó la revisión: un editor de una revista, un organizador de conferencias, una agencia de financiación, un cuerpo docente, etc.
- Identificador de organización: El identificador persistente de la organización convocante. Actualmente admitimos el identificador de registro de financiadores ROR, Ringgold**, GRID, LEI o Crossref. Tenga en cuenta: este no es un campo obligatorio, pero le recomendamos que publique estos datos si los tiene disponibles.
- Revisar datos: * Estos datos se refieren a la actividad de revisión y no a lo que se revisó
- Tipo: El tipo de actividad de revisión: revisión o evaluación
- Fecha: La fecha en que se completó la revisión. Esto puede ser amplio (2008) o específico (2010-12-10)
- Identificador de revisión: Un único, preferiblemente resoluble identificador proporcionada por la fuente de la revisión en sí. A menos que la revisión esté disponible abiertamente, recomendamos que no contenga datos identificables que se puedan rastrear hasta el sujeto de la revisión.
- URL de revisión: Un enlace a una representación de la revisión o el registro de revisión en línea
- Información sobre el tema de la revisión: Lo que sea que revisó el revisor
- Tipo de asunto: El tipo de artículo que se revisó, por ejemplo, artículo de revista, artículo de conferencia
- Esto incluye la lista de tipos de trabajo Y la lista de tipos de subvenciones ("Subvención", "contrato", "adjudicación", "salario-adjudicación") E investigación- "propuesta de recurso" Y "indefinido"
- Nombre del tema: El nombre del elemento revisado
- Identificador externo del sujeto: El identificador único del sujeto de la revisión, por ejemplo, un artículo DOI
- Nombre del contenedor del sujeto: El nombre del objeto del que forma parte el tema de la revisión, por ejemplo, la conferencia para la que se revisó el artículo.
- URL del asunto: La URL del tema que se revisó.
- Tipo de asunto: El tipo de artículo que se revisó, por ejemplo, artículo de revista, artículo de conferencia
* Indica campo requerido
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
Hay muchos tipos de recursos de investigación, desde reactivos de un solo uso hasta colaboraciones internacionales con instalaciones dedicadas. ORCID admite un modelo de alto nivel que se puede vincular a otros lugares para obtener detalles específicos del dominio.
Hay cuatro tipos de recursos de alto nivel:
Tipo de Recurso | Definición | Ejemplos |
EN LA MINA | Una instalación, edificio u otro espacio físico utilizado para realizar investigaciones. | Fuente de espalación de neutrones, instalación animal, enclave de datos, sitio arqueológico, conjunto de telescopios. barcos, aviones, granjas, laboratorios |
Colecciones | Un objeto o grupo de objetos utilizados con fines de investigación; puede ser tangible o digital | Misión oceánica, campaña de campo, conjuntos de datos o recursos colaborativos, colección de libros raros; colección de museo, colección de muestras biológicas |
Equipo | Hardware utilizado con fines de investigación | Microscopio, computadoras, cristalería, muestras, materiales. |
Servicio | Servicios utilizados con fines de investigación | Análisis proteómico, servicios informáticos, análisis de datos, soporte logístico, servicios legales, corrección de estilo, asesoramiento de expertos o personal |
Además del tipo de recurso, un elemento de recurso de investigación dentro de un ORCID El registro contiene la siguiente información. * indica los elementos requeridos
- Título de la propuesta / registro: * Este es el campo de visualización principal para los recursos de investigación, por ejemplo, "Premio Neutron Beam" o "Tiempo de haz y recursos informáticos"
- Propuesta / ID de registro: * Este es el identificador público (DOI, PURL, etc.) de la propuesta o solicitud para utilizar el recurso. Idealmente, este identificador debe ser persistente y resolverse en una página de destino pública con información sobre la propuesta o solicitud, como una base de datos de premios o un registro de usuario de recursos.
- Anfitrión (es) de la propuesta: * Esta es la organización que recibe y procesa las propuestas o solicitudes de recursos. El anfitrión de la propuesta puede ser el mismo que el anfitrión de recursos
- ID de la organización anfitriona de la propuesta * Este es el identificador público (uno de ROR, GRID, Open Funder ID, LEI) para la organización que administra el proceso de propuesta o solicitud
- Recursos):* (hasta 100)
- Nombre del recurso:* - p. Ej., "Fuente de espalación de neutrones"
- ID de recurso (s): * - de una lista extensible de tipos de PID aceptables (por ejemplo, RRID, DOI, URI)
- Tipo de recurso:* - uno de 'Infraestructuras', 'Colecciones', 'Equipo' o 'Servicios'
- Anfitrión (es) de recursos: * Esta es la organización que administra u opera el recurso, como un laboratorio nacional, una agencia gubernamental o una universidad de investigación.
- ID de la organización anfitriona del recurso:* Este es el identificador público (uno de ROR, GRID, Ringgold**, Open Funder ID, LEI) de la organización que aloja el recurso.
- URL de la propuesta: Un enlace a la propuesta
- Fecha de inicio de la propuesta: La fecha en que comenzó el acceso
- Fecha de finalización de la propuesta: La fecha en que finalizó o finalizará el acceso
* Indica campo requerido
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
- Título:* El titulo de la obra
- Subtítulo: Un subtítulo de la obra
- Título traducido: El título bajo el que aparece la obra en otro idioma, el idioma del título traducido se registra como un atributo
- Título de la revista: El nombre de una colección más grande a la que pertenece el trabajo, como una revista para artículos de revistas o un libro para capítulos de libros. A pesar de que está etiquetado como título de revista, se puede usar para otros trabajos.
- Breve descripción: Una breve descripción o resumen del trabajo.
- Tipo de cita: El formato en el que se proporciona la cita. Este campo se selecciona de una lista que contiene los siguientes valores: APA, BIBTEX, CHICAGO, HARVARD, IEEE, MLA, RIS, UNSPECIFIED, VANCOUVER
- Valor de cita: El contenido de la cita
- Tipo de trabajo: El tipo de objeto que es la obra. Este campo debe seleccionarse de la tipos de trabajo admitidos
- Fecha de publicación: Fecha de publicación de la obra. Recomendamos que se utilice la fecha de publicación más antigua
- Tipo de identificación externa: * El tipo de identificador. Este campo debe seleccionarse de la identificadores de trabajo admitidos
- Valor-id-externo: * El identificador en sí
- URL de identificación externa: Una URL en la que se resuelve el identificador
- Relación de identificación externa: * Los identificadores que se aplican solo al trabajo que se agrega se marcarán como Self. Los identificadores que se aplican a una colección más grande a la que pertenece este trabajo se establecerían en Parte de. Los identificadores que se aplican a versiones alternativas del trabajo se establecerían en versión de. Los identificadores que se aplican a la financiación del trabajo se establecerían en financiado por.
- URL de trabajo: Una URL que enlaza con el trabajo.
- Colaboradores de trabajo: Información sobre las personas que crearon la obra.
- Código de lenguaje: El idioma utilizado para describir el trabajo en los campos anteriores
- Canton: Un país en el que se publicó el trabajo o con el que se asoció de otro modo
* Indica campo requerido
Todas las secciones de afiliación utilizan el mismo conjunto de metadatos en la API:
- Nombre de la organización:* El nombre de la organización al más alto nivel (por ejemplo, "Universidad de Boston", en lugar de "Facultad de Medicina de la Universidad de Boston").
- Ciudad de la organización: * Ciudad donde tiene su sede la organización.
- Región de la organización: Región donde se encuentra la organización.
- País de la organización * el país de la organización. Esto debe llenarse con el código de país ISO 3166 Alpha-2 de dos letras.
- Identificación de la organización (ROR, GRID, Ringgold** o LEI):* Un identificador único para la organización y su origen. Recomendamos que se utilice el ID de la organización principal dentro de la afiliación y no de la división o el departamento.
- Rol / Título: El cargo que ocupa, o el título otorgado o por otorgar.
- Departamento: Cualquier subdivisión de la organización matriz.
- URL: Una URL a un recurso sobre la afiliación.
- Fecha de inicio: La fecha en que comenzó la relación entre el investigador y la organización (se puede especificar por año, mes y día).
- Fecha de finalización: La fecha en que terminó la relación entre el investigador y la organización (se puede especificar hasta año, mes y día)
- Un identificador persistente externo que describe la afiliación: Un identificador único para la afirmación de afiliación real.
*Indica un campo obligatorio.
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
- Tipo de financiación: * El tipo de financiación concedida, este campo se selecciona de una lista que contiene los siguientes valores: Adjudicación, Contrato, Subvención, Salario
- Título de financiación: * El título del elemento de financiación
- Subtítulo: Un subtítulo del elemento de financiación
- Título traducido: El título bajo el que aparece la financiación en otro idioma, el idioma del título traducido se registra como un atributo
- Descripción: Una descripción o un breve resumen del proyecto financiado.
- Cantidad: El valor del premio
- Identificador de financiación único: Agregue tantos de estos como su sistema sepa, ya que ayuda a agrupar en ORCID Records.
- Tipo de identificador de financiación: Utilice número de concesión, DOI, URI o ID de propuesta.
- Valor del identificador
- URL del identificador (opcional)
- Relación: uno mismo / parte de
Esto es para indicar la relación del elemento de financiación con el identificador. Por ejemplo, si el elemento de financiación es para una fase de una subvención de varias partes, y el identificador es para la subvención de varias partes, entonces la relación sería "parte de"; si el identificador es para la fase individual, entonces la relación sería "yo".
- Agencia financiadora (organización): * Información sobre la organización que otorgó la financiación
- Nombre de la agencia
- Dirección (ciudad y país)
- Identificador de organización:
- Fecha de inicio: La fecha en que comenzó la financiación
- Fecha de finalización: La fecha en que terminó la financiación
- Información de los colaboradores: Información sobre las personas que recibieron la financiación
- ORCID identificación: La acreditación ORCID iD de cada colaborador al proyecto de financiación; esto solo debe incluir autenticado ORCID identificaciones
- Papel: La naturaleza de la contribución del investigador
* Indica campo requerido
Todas las secciones de afiliación utilizan el mismo conjunto de metadatos en la API:
- Nombre de la organización:* El nombre de la organización al más alto nivel (por ejemplo, "Universidad de Boston", en lugar de "Facultad de Medicina de la Universidad de Boston").
- Ciudad de la organización: * Ciudad donde tiene su sede la organización.
- Región de la organización: Región donde se encuentra la organización.
- País de la organización * el país de la organización. Esto debe llenarse con el código de país ISO 3166 Alpha-2 de dos letras.
- Identificación de la organización (ROR, Ringgold**, GRID o LEI):* Un identificador único para la organización y su origen. Recomendamos que se utilice el ID de la organización principal dentro de la afiliación y no de la división o el departamento.
- Rol / Título: El cargo que ocupa, o el título otorgado o por otorgar.
- Departamento: Cualquier subdivisión de la organización matriz.
- URL: Una URL a un recurso sobre la afiliación.
- Fecha de inicio: La fecha en que comenzó la relación entre el investigador y la organización (se puede especificar por año, mes y día).
- Fecha de finalización: La fecha en que terminó la relación entre el investigador y la organización (se puede especificar hasta año, mes y día)
- Un identificador persistente externo que describe la afiliación: Un identificador único para la afirmación de afiliación real.
*Indica un campo obligatorio.
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
Todas las secciones de afiliación utilizan el mismo conjunto de metadatos en la API:
- Nombre de la organización:* El nombre de la organización al más alto nivel (por ejemplo, "Universidad de Boston", en lugar de "Facultad de Medicina de la Universidad de Boston").
- Ciudad de la organización: * Ciudad donde tiene su sede la organización.
- Región de la organización: Región donde se encuentra la organización.
- País de la organización * el país de la organización. Esto debe llenarse con el código de país ISO 3166 Alpha-2 de dos letras.
- Identificación de la organización (ROR, GRID, RInggold** o LEI):* Un identificador único para la organización y su origen. Recomendamos que se utilice el ID de la organización principal dentro de la afiliación y no de la división o el departamento.
- Rol / Título: El cargo que ocupa, o el título otorgado o por otorgar.
- Departamento: Cualquier subdivisión de la organización matriz.
- URL: Una URL a un recurso sobre la afiliación.
- Fecha de inicio: La fecha en que comenzó la relación entre el investigador y la organización (se puede especificar por año, mes y día).
- Fecha de finalización: La fecha en que terminó la relación entre el investigador y la organización (se puede especificar hasta año, mes y día)
- Un identificador persistente externo que describe la afiliación: Un identificador único para la afirmación de afiliación real.
*Indica un campo obligatorio.
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
Trabaja en ORCID se agrupan según sus identificadores y la relación de esos identificadores con la obra. Hay cuatro tipos de relaciones:
- Propia: el identificador se refiere únicamente a esa obra y se puede agrupar con otras obras que tengan el mismo identificador
- Parte de: la obra forma parte de este identificador y no se puede agrupar con otras obras
- La versión de: estos identificadores se aplican a versiones alternativas del trabajo y se pueden agrupar con uno mismo y con la versión de los identificadores
- Fundado por: estos identificadores se aplican a la financiación del trabajo. Estos identificadores no se utilizan para agrupar obras.
Nuestra API proporciona soporte para esto en XSD. Cada elemento tiene un atributo de índice de visualización que indica su clasificación dentro de su grupo. El índice de visualización más alto es el elemento preferido seleccionado por el investigador. Los elementos agregados a través de la API que no han sido clasificados por el investigador tienen un índice de visualización de 1 y se utilizan como fuente preferida predeterminada dentro del grupo hasta que el investigador los cambie. El índice de visualización también determina la orden de trabajo al leer el ORCID registrar con la API.
Para obtener más información sobre la agrupación en ORCID registros, consulte nuestro Artículo de apoyo.
An ORCID El registro puede contener información sobre el trabajo de un investigador, afiliaciones, financiamiento, revisión por pares y más.
Elementos en ORCID los registros se pueden dividir en afirmaciones que conectan el ORCID Titular de identificación con actividad o afiliación. Estas afirmaciones se pueden agregar a una ORCID registro por parte del investigador que posee el registro, o por sistemas a los que el investigador ha otorgado permiso para hacerlo. Llamamos a la entidad que agregó una aserción a una ORCID grabar el fuente.
Ejemplos
Siguiendo nuestros principios de transparencia y apertura, creemos que es importante poder ver la fuente de la afirmación: quién agrega esa información al registro. Así es como lo hacemos:
- Cuando un investigador (o su delegado individuo de confianza) agrega una afirmación a su registro, ORCID registra automáticamente a esa persona como fuente
- Cuando un sistema aprobado por el investigador agrega una afirmación a un registro, ORCID registra automáticamente el propietario del sistema (un ORCID miembro) como fuente.
Mostramos el nombre de la fuente en la interfaz de usuario y lo ponemos a disposición (con su identificador único) en la API:
Sin embargo, los flujos de trabajo de información de investigación pueden ser más complicados que esto, y la fuente real de una afirmación puede quedar oculta involuntariamente por un sistema que agrega un elemento en nombre de una persona u otro sistema. Para garantizar la transparencia, debemos distinguir entre quién hizo la conexión entre la persona y el elemento y quién agregó el elemento al registro. Como se indicó anteriormente, quien agregue el artículo al ORCID registro es el fuente; quien crea la conexión entre el ORCID iD y el artículo es el origen de la aserción.
Por ejemplo:
- Un investigador importa datos a su ORCID registro de un sistema, como un asistente de búsqueda y enlace. El investigador está haciendo la afirmación que conecta sus iD con el artículo, por lo que son los origen de la aserción; mientras que el sistema es la entidad que agrega la aserción a la ORCID registro - el fuente
- Un investigador interactúa con el Sistema A (el origen de la afirmación), que utiliza los servicios proporcionados por el Sistema B para actualizar ORCID registros, haciendo del Sistema B el fuente
Alentamos a nuestra comunidad a tomar medidas para preservar y compartir información sobre el origen de las afirmaciones, de modo que todos puedan beneficiarse al ver la fuente.
Para obtener más información, consulte:
ORCID permite la adición de varios tipos de obras. A continuación se muestra una lista de los tipos de trabajo que se admiten actualmente, que es en gran medida consistente con el Estándar de Salida CASRAI.
Publicaciones
Tipo de trabajo | Usa |
primer libro | Libros escritos por un solo autor o basados en colaboración en investigaciones o hallazgos académicos generalmente derivados de fondos revisados por pares. |
capítulo del libro | Textos escritos por un solo autor o basados en colaboración en investigaciones o hallazgos académicos y experiencia en un campo. |
reseña del libro | Revisión crítica de obras de ficción o no ficción destacando las contribuciones a un arte, campo o disciplina. |
entrada de diccionario | Entradas de nuevas palabras, nuevos significados de palabras existentes, cambios en la ortografía y la separación de sílabas durante un período de tiempo más largo y cambios gramaticales. |
disertación | Tratado que avanza un punto de vista original fruto de la investigación: requisito para el título de doctor. Esto solo está disponible con API v2.x |
disertación-tesis | Un trabajo que normalmente se basa en una investigación original y que da evidencia del dominio del candidato tanto de su propia materia como del método académico. Esto solo está disponible con API v3.0+ |
entrada de enciclopedia | Entradas de autor en una obra de referencia o un compendio que se centre en un dominio en particular o en todas las ramas del conocimiento. |
Libro editado | Libros editados por un solo autor o en colaboración para la difusión de investigaciones o hallazgos académicos que generalmente son el resultado de la financiación revisada por pares. |
artículo de revista | Artículos en publicaciones revisadas por pares que difunden los resultados de investigaciones y becas originales. |
número de revista | Publicaciones periódicas destinadas a fomentar el debate y la investigación intelectual. |
Artículo de revista | Artículos en publicaciones temáticas publicados a intervalos fijos. |
manual | Materiales de cursos y tareas elaborados con fines didácticos. |
recurso en línea | Información accesible solo en la web a través de métodos técnicos tradicionales |
boletín-artículo | Artículos en publicaciones dirigidos a investigadores, tomadores de decisiones, profesionales y público que informan sobre un proyecto de investigación o sobre las actividades de una cátedra de investigación o un centro de investigación. |
artículo de periódico | Artículos en una publicación diaria, semanal o mensual que informa sobre noticias y temas sociales dirigidos al público. |
preprint | Versión de un artículo puesto a disposición del público antes de la revisión y publicación formal por pares. Esto solo está disponible con API v3.0 + |
reporte | Informes que difunden los resultados y entregables de un contrato de investigación. |
una estrategia SEO para aparecer en las búsquedas de Google. | Una evaluación formal del trabajo de otro. Esto solo está disponible con API v3.0+ |
herramienta de búsqueda | Serie de observaciones, mediciones o hechos identificados a partir de la investigación. |
publicación-estudiantil-supervisada | Artículos sobre resultados de investigación publicados conjuntamente o supervisados por el asesor de tesis. |
test | Evaluaciones que incluyen pruebas diseñadas para la selección universitaria general, selección en cursos específicos u otros propósitos de evaluación. |
traducción | Traducciones de libros y artículos que identifiquen modificaciones a la edición original, como un prefacio nuevo o revisado. |
website | Ubicaciones independientes en la web donde se encuentran disponibles varios tipos de información sobre un tema específico. |
hoja de trabajo | Versiones preliminares de artículos que no han sido revisados pero que pueden ser compartidos para comentarios. |
Congreso
Tipo de trabajo | Usa |
resumen de conferencia | Textos de una extensión determinada que indiquen el tema que se debatirá en un documento de conferencia propuesto. |
documento de sesión | Artículos escritos solos o en colaboración, presentados en una conferencia académica y publicados en las actas (no en revistas académicas). |
cartel de conferencia | Carteles que se exhiben en un entorno de conferencia y transmiten los aspectos más destacados de la investigación de manera eficiente mediante gráficos atractivos |
Propiedad intelectual
Tipo de trabajo | Usa |
revelación | Publicaciones que establecen invenciones como estado de la técnica evitando así que otros patenten la misma invención o concepto. |
licencia | Acuerdos firmados para explotar una parte de la propiedad intelectual, como un proceso, producto, datos o software. |
patentar | Una forma de protección de la propiedad intelectual que define el derecho exclusivo por ley de los inventores y cesionarios de hacer uso y explotar sus invenciones, productos o procesos, durante un período de tiempo limitado. |
derechos de autor registrados | Propiedad registrada de derechos bajo un sistema de leyes para promover tanto la creación como el acceso a obras artísticas, literarias, musicales, dramáticas y otras obras creativas. |
marca | Marcas como un nombre, palabra, frase, logotipo, símbolo, diseño, imagen de un producto o servicio que indica la fuente y otorga el derecho a controlar el uso del identificador. |
Otros
Tipo de trabajo | Usa |
anotación | Las anotaciones contienen comentarios o descripciones sobre otro recurso. Esto solo está disponible con API v3.0 + |
actuación artística | Recopilación de registros de información que, en combinación, representan un historial completo y actualizado de resultados artísticos o de desempeño que resultan de, o están relacionados con, la investigación o las actividades académicas de la persona. |
plan de manejo de datos | Una declaración formal que describe cómo se gestionarán y documentarán los datos de investigación a lo largo de un proyecto de investigación y los términos relacionados con el depósito posterior de los datos en un depósito de datos para su gestión y conservación a largo plazo. Esto solo está disponible con API v3.0 + |
conjunto de datos | Una serie de observaciones, mediciones o hechos estructurados identificados a partir de la investigación que se pueden almacenar en un medio de base de datos. |
invención | Resultados prácticos y originales que surgen de la investigación. |
conferencia-discurso | Una charla informativa relacionada con la investigación dirigida a una audiencia. |
objeto físico | Un espécimen, muestra u otro objeto físico utilizado con fines de investigación; un objeto o sustancia tridimensional inanimado. Esto solo está disponible con API v3.0 + |
técnica de investigación | A métodos prácticos o habilidades aplicadas a tareas particulares identificadas como parte de la investigación. |
software | Un programa utilizado para operar una computadora u otro dispositivo técnico. |
empresa derivada | Una empresa creada por una organización de investigación para hacer un uso comercial de los resultados y hallazgos del proyecto de investigación. |
normas-y-política | El desarrollo de una regla o principio que se utiliza como base para el juicio. |
estándar técnico | Normas Técnicas (industriales o de otro tipo) que se hayan originado a partir de los proyectos de investigación en los que se puedan desarrollar nuevos protocolos, métodos o materiales. |
other | Cualquier otro tipo de trabajo. |
ORCID apoya el uso de Identificadores ROR, Identificadores GRID y Registro de financiadores de Crossref identificadores para eliminar la ambigüedad de las organizaciones en ORCID Records.
Para más información, consulte la Trabajar con identificadores de organización
Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información
Consulta nuestra lista de identificadores admitidos para la API V3.0. Ocasionalmente agregamos nuevos tipos a pedido de ORCID miembros que deseen utilizarlos al agregar elementos al registro.
- Primera
- Adicionales
Roles para trabajos API 2.0
A continuación, se muestra la lista de funciones de colaborador compatibles con API 2.0.- autor
- cesionario
- editor
- silla-o-traductor
- co-investigador
- coinventor
- estudiante graduado
- otro inventor
- investigador principal
- investigador postdoctoral
- personal de apoyo
Roles para trabajos API 3.0
Con API 3.0, puede agregar los roles anteriores más roles CREDIT adicionales. La taxonomía CRediT consta de 14 tipos de contribución al trabajo académico, junto con pautas sobre cómo se pueden asignar estos roles. A continuación se muestra la lista completa con el valor de la interfaz de usuario y el valor de los metadatos. El valor de los metadatos es la URL según las recomendaciones de implementación de NISO.CRediT debe codificarse en JATS xml v1.2, que se describe a través de este enlace: https://jats4r.org/credit-taxonomy.' Solo se aceptará la URL al agregar roles a través de la API.Ejemplo de metadatos de colaborador de trabajo:
https://orcid.org/0000-0001-5109-3700 0000-0001-5109-3700 orcid.org Laure L. Haak first author
Roles para la financiación
- Lead
- co-líder
- Apoyado por
- otra-contribución
Hemos introducido un nuevo campo generado por el sistema, que expresa identificadores externos (DOI, PMCID, PMID, ArXiv, Bibcode, ISSN e ISBN) en un formato normalizado con el fin de hacer coincidir y agrupar. La normalización se realiza según las reglas del tipo de identificador y puede incluir establecer todos los caracteres alfabéticos en minúsculas o transformar espacios, guiones, puntos y otros caracteres que pueden tratarse como equivalentes. También agrega prefijos y sufijos estándar según corresponda. Por ejemplo, https://doi.org/10.1/123, 10.1/123y https://dx.doi.org/10.1/123 todos aparecerán en este campo como https://doi.org/10.1/123. El valor del identificador existente no se modifica.
Cualquier autor en el que su editor utilice Crossref para su registro DOI puede beneficiarse de la integración de actualización automática de Crossref.
Los editores deben incluir el autenticado ORCID ID de sus autores dentro de los metadatos enviados a Crossref en el registro DOI.
Crossref solicitará permiso al autor a través de una notificación a su ORCID bandeja de entrada para actualizar su ORCID grabar con esta publicación y cualquier publicación nueva de cualquier editor.
Para más información, consulte: https://www.crossref.org/community/orcid/
ORCID proporciona un campo de citas de texto libre para que los investigadores puedan ingresar fácilmente la información en formato de texto. Sin embargo, recomendamos encarecidamente a todos los usuarios de API que agreguen citas en BibTeX, que es legible por máquina. El formato venerable, a pesar de ser anterior a Internet, puede ser transformado al formato deseado por integraciones y autores. Es compatible con la mayoría de los administradores de referencias y plataformas de publicación.
Para obtener más información sobre BibTeX, consulte https://www.bibtex.org.
Como beneficio de ORCID membresía, las organizaciones pueden solicitar ORCID para admitir tipos de PID adicionales en el ORCID Registro. Por ejemplo, un miembro podría solicitar que agreguemos soporte para los PID que utilizan para identificar muestras o conjuntos de datos en su base de datos de geología. Esto permite establecer vínculos entre las muestras y las personas que las recogieron. Y, debido a que todos los nuevos tipos de PID que agreguemos deben ser al menos resolubles, y preferiblemente FAIR, esos vínculos son inequívocos, persistentes en el tiempo y procesables, lo que beneficia al investigador, la organización miembro y la comunidad en general.
¡Agregando su PID!
Como organización comunitaria, queremos asegurarnos de que ORCID admite los PID utilizados por nuestros miembros. Mantenemos una completa lista de identificadores existentes admitidos en el Registro e invitar ORCID miembros para usar este formulario. para solicitar PID adicionales. Nuestro objetivo es responder a su solicitud lo antes posible.
Cada elemento de la ORCID iD se le asigna un código de venta que lo identifica de forma única. Al leer un registro completo o una sección, el código de venta se puede encontrar como un atributo del artículo. Cuándo llamar a un elemento específico en un registro, el código de venta se utiliza para identificar el artículo. Los códigos de venta son únicos dentro del tipo de artículo al que se refieren. Usando este ejemplo, solo un trabajo en el ORCID El registro tendrá el código de colocación 733535, aunque 733535 también se puede utilizar como código de colocación para un elemento de financiación o una palabra clave.
Id únicos totales: El número de investigadores que han dado permiso a una integración perteneciente a su organización. Esto incluye permisos de solo lectura y de actualización. Cada investigador solo se cuenta una vez, sin importar con cuántas integraciones se haya conectado.
Tus integraciones: una lista de integraciones para su organización que utilizan la API de miembros con los recuentos adjuntos de iD conectados y registros actualizados. También se incluye el nombre del sistema de terceros que se utiliza para integrarse con ORCID donde corresponda.
Nuevos usuarios por año: un gráfico que muestra a los usuarios que se conectan a cada una de sus integraciones a lo largo del tiempo.
Los informes más antiguos que admitimos antes de 2022 ya no están disponibles para que los vea. Si tiene alguna pregunta sobre los informes anteriores, comuníquese con [email protected]
ORCID tiene una sección separada en el ORCID registro para registrar información sobre calificaciones, acreditaciones, certificados e insignias.
Cada elemento de calificación siempre contendrá:
- El título de calificación
- El ID de la organización del proveedor (por ejemplo, ID ROR)
- La fecha en que se agregó al ORCID grabar
- Quién agregó la calificación (la fuente)
Pueden contener:
- La fecha de validez, incluida una fecha de finalización si expira la calificación
- La identificación persistente de calificación, que identifica el tipo de calificación obtenida.
- La URL de calificación, que contiene una descripción legible por humanos del tipo de calificación obtenida.
- El identificador permanente de la calificación. Debe vincularse a una versión en línea del certificado de calificación. Puede ser un identificador único existente o simplemente un URI.
Registros actualizados con afiliaciones: Una métrica que cuenta cuántos iD se han actualizado por sus integraciones con un tipo de elemento en particular, por ejemplo, trabajos, afiliaciones
Afiliaciones totales añadidas: Una métrica que cuenta cuántos elementos de un elemento en particular se han agregado
Tipos de afiliaciones añadidas: Un porcentaje de la cantidad de cada tipo de afiliación que se ha agregado, por ejemplo, Empleo, Educación
Se agregaron identificadores de organización: Una tabla que enumera los tipos de afiliación y los ID de organización utilizados por su integración al agregar afiliaciones a los registros, junto con un recuento de registros actualizados con ese ID de organización.
Registros totales actualizados: La cantidad de investigadores que se han beneficiado de las actualizaciones automáticas de sus registros realizadas por sus integraciones.
iD únicos conectados por año: Un gráfico que muestra los iD conectados desglosados por año.
Registros actualizados por año por integración: La cantidad de investigadores que se han beneficiado de las actualizaciones automáticas de sus registros realizadas por sus integraciones.
Total de artículos agregados por año por integración: un gráfico que muestra la cantidad de elementos agregados por sus integraciones cada año
Registros actualizados con obras: El número de registros que han tenido al menos un trabajo agregado por una integración
Total de obras añadidas: El número total de obras añadidas por tus integraciones
Tipos de obras añadidas: Un porcentaje de la cantidad de cada tipo de trabajo que se ha agregado, por ejemplo, artículo de revista, preimpresión
Registros actualizados con revisión por pares: El número de registros que han tenido al menos una revisión por pares agregada por una integración
Revisión por pares total agregada: el número total de revisiones de pares agregadas por sus integraciones
Registros actualizados con sitios web y enlaces sociales: La cantidad de registros que tienen al menos un sitio web y un enlace social agregado por una integración
Registros actualizados con identificadores personales: El número de registros que tienen al menos un identificador personal agregado por una integración
Registros actualizados con financiación: El número de registros que tienen al menos un financiamiento agregado por una integración
Financiación total añadida: El número total de fondos agregados por sus integraciones
Registros actualizados con recursos de investigación: El número de registros que tienen al menos un recurso de investigación agregado por una integración
Países de afiliación: Un gráfico que muestra los códigos de país dentro de los metadatos de afiliación de los Connected ID.
Afiliaciones actuales: Una tabla que enumera las afiliaciones encontradas en todos los iD con código de país, desglosadas por ID de organización y tipo. Solo incluye las afiliaciones actuales, es decir, aquellas sin fecha de finalización.
Código de país: Un gráfico que muestra los códigos de país restringidos dentro de los metadatos biográficos de las identificaciones conectadas.
Ubicación del usuario durante el último año: Un gráfico que muestra dónde se encontraba su usuario al otorgar permiso a su organización a través de OAuth
Registros totales con dominios: Una métrica que cuenta el número total de identificaciones que tienen una dirección de correo electrónico que termina en uno de los dominios registrados. Si el registro tiene una dirección de correo electrónico con más de uno de los dominios registrados, se incluirán en el recuento más de una vez. Si desea agregar dominios adicionales, háganoslo saber.
Registros con dominios registrados: Una lista de sus dominios de correo electrónico registrados junto con la cantidad de registros que usan ese dominio.
Registros por subdominio: Una lista de sus subdominios de correo electrónico registrados junto con la cantidad de registros que usan ese subdominio
Registros que agregan dominios de correo electrónico por año: Un gráfico que muestra el uso de dominios registrados a lo largo del tiempo. Es posible que los investigadores hayan registrado más de una dirección de correo electrónico y este gráfico cuenta todas las direcciones de los investigadores.
Esta sección muestra la cantidad de registros que han actualizado sus integraciones
Registros actualizados con afiliaciones: Una métrica que cuenta cuántos iD han sido actualizados por sus integraciones con afiliaciones.
Afiliaciones totales añadidas: una métrica que cuenta cuántas afiliaciones se han agregado
Tipos de afiliación añadidos: Un porcentaje de la cantidad de cada tipo de afiliación que se ha agregado, por ejemplo, Empleo, Educación
Se agregaron identificadores de organización: Una tabla que enumera los tipos de afiliación y los ID de organización utilizados por su integración al agregar afiliaciones a los registros, junto con un recuento de registros actualizados con ese ID de organización.
Registros actualizados con obras: Una métrica que cuenta cuántos iD han sido actualizados por sus integraciones con trabajos
Total de obras añadidas: Una métrica que cuenta cuántas obras se han agregado
Tipos de trabajos añadidos: Un porcentaje de la cantidad de cada tipo de trabajo que se ha agregado, por ejemplo, artículo de revista, preimpresión
Registros actualizados con revisiones por pares: Una métrica que cuenta cuántos registros han sido actualizados por sus integraciones con una revisión por pares
Total de revisiones por pares añadidas: Una métrica que cuenta cuántas revisiones de pares se han agregado
Registros actualizados con financiación: Una métrica que cuenta cuántos registros han sido actualizados por sus integraciones con una financiación
Financiamiento total agregado: una métrica que cuenta cuántos fondos se han agregado
Registros actualizados con un identificador personal: Una métrica que cuenta cuántos registros han sido actualizados por sus integraciones con un identificador personal
Registros actualizados con recursos de investigación: Una métrica que cuenta cuántos registros han sido actualizados por sus integraciones con recursos de investigación
Registros actualizados con sitios web y enlaces sociales: Una métrica que cuenta cuántos registros han sido actualizados por sus integraciones con un sitio web o enlace social
Esta sección muestra la cantidad de investigadores que interactúan con sus integraciones.
ID conectados: El número de investigadores que han dado permiso a una integración perteneciente a su organización. Esto incluye permisos de solo lectura y de actualización. Cada investigador solo se cuenta una vez, sin importar con cuántas integraciones se haya conectado.
ID conectados: Lista de conectados ORCID ID, incluido el nombre del registro.
Registros actualizados con esta integración: La cantidad de investigadores que se han beneficiado de las actualizaciones automáticas de sus registros realizadas por sus integraciones.
iDs conectados por primera vez: un gráfico que muestra los iD conectados a lo largo del tiempo.
Registros actualizados por primera vez: Un gráfico que muestra Registros actualizados a lo largo del tiempo. Cada iD se cuenta una vez, según el año en que se actualizaron por primera vez
ID únicos conectados por año: Un gráfico que muestra los Connected iD desglosados por año.
Registros únicos actualizados por año: Un gráfico que muestra Registros actualizados desglosados por año.¬¨‚
Esta sección muestra cuántos investigadores están conectados al país del consorcio. Esto será más relevante para los consorcios nacionales. Tenga en cuenta que la información que se muestra puede haber sido agregada o no por los miembros del consorcio.
País del consorcio: Código de país de su consorcio
Total de iD afiliados al país: Una métrica que muestra el número total de iD en el registro que tienen el código de país del consorcio dentro de la sección de afiliación de su registro. Incluye todas las afiliaciones, pasadas y presentes.
ID con código de país: Una métrica que muestra el número total de iD en el registro que tienen el código de país del consorcio dentro de la sección de biografía de su registro.
Total de iD afiliados al país (actual): Una métrica que muestra el número total de iD en el registro que tienen el código de país del consorcio dentro de la sección de afiliación de su registro. Sólo incluye afiliaciones vigentes, es decir, aquellas sin fecha de finalización.
Afiliaciones actuales (para todos los iD con país):Una tabla que enumera las afiliaciones encontradas en todos ID con código de país, desglosado por ID de organización y tipo. Solo incluye afiliaciones actuales, es decir, aquellas sin fecha de finalización.
iDs activos con código de país: Número de registros activos (registrados o actualizados en los últimos 365 días) con código de país del consorcio
Esta sección muestra el número de registros de investigadores que han actualizado las integraciones de miembros del consorcio. Se puede utilizar para comprender qué tan bien los miembros del consorcio están ayudando a sus investigadores a mantener sus registros actualizados.
Registros únicos actualizados por año: Un gráfico que muestra Registros actualizados desglosados por año. Los investigadores se cuentan para todos los años en los que fueron actualizados por un miembro del consorcio.
ID únicos conectados por año: Un gráfico que muestra los iD conectados desglosados por año. Los investigadores se cuentan para todos los años en los que otorgaron el permiso.
Registros actualizados por año por integración: Un gráfico que muestra registros actualizados desglosados por año e integración dentro de sus consorcios
Esta sección muestra el número de investigadores que interactúan con integraciones de miembros de consorcios.
Total de miembros del consorcio: El número total de miembros en su consorcio
Integraciones totales: El total de integraciones en tu consorcio
Integraciones activas: El número de integraciones en sus consorcios que han actualizado al menos un registro
iD totales conectados: Número de investigadores que han dado permiso de integración a un miembro perteneciente a los consorcios. Esto incluye permisos de solo lectura y de actualización. Cada investigador solo se cuenta una vez, sin importar con cuántas integraciones se haya conectado
Registros actualizados
El número de investigadores que se han beneficiado de las actualizaciones automáticas de sus registros realizadas por miembros de consorcios.
Integraciones de miembros de consorcios:
Una lista de integraciones registradas por los miembros de los consorcios, con los recuentos adjuntos de Connected iD, registros actualizados, qué sistema de proveedor de servicios se utiliza, si corresponde, y si la integración es para el portal de miembros (Affiliation Manager)
Nuevos usuarios por año por integración: un gráfico que muestra a los usuarios que se conectan a cada una de sus integraciones a lo largo del tiempo.
Esta sección muestra dónde se originan los iD conectados
Países de afiliación actual: Un gráfico que muestra los códigos de país dentro de los metadatos de afiliación de ID conectados.
afiliaciones actuales: Tabla que enumera las afiliaciones encontradas en todos los iD con código de país, desglosadas por ID de organización y tipo. Solo incluye las afiliaciones actuales, es decir, aquellas sin fecha de finalización.
Ubicación del usuario: un gráfico que muestra dónde se basó su usuario al otorgar permiso a su organización a través de OAuth
Código de país: Un gráfico que muestra los códigos de país restringidos dentro de los metadatos biográficos de las identificaciones conectadas.
Registros actualizados con afiliaciones: Una métrica que cuenta cuántos iD han sido actualizados por integraciones de miembros de consorcios con una afiliación
Tipos de afiliación añadidos: Un porcentaje de cuántos de cada tipo de afiliación se han agregado.
Afiliaciones totales añadidas: Una métrica que cuenta cuántas afiliaciones han sido agregadas por integraciones de miembros de consorcios
Miembros de consorcios que agregan afiliaciones: Una lista de cuántas afiliaciones han sido agregadas por integraciones de miembros de consorcios
Se agregaron identificadores de organización:Una lista de cuántos identificadores de organizaciones han sido agregados por integraciones de miembros de consorcios.
Esta sección muestra cuántos investigadores se han registrado utilizando los dominios de correo electrónico con los que se ha registrado el consorcio. ORCID. Se pueden registrar un máximo de cinco direcciones de correo electrónico.
Dominio de correo electrónico nacional: Los ORCID tiene para el dominio de correo electrónico nacional de sus países
Registros con dominio nacional: Un recuento de registros que tienen una dirección de correo electrónico con su dominio de correo electrónico nacional
Dominios de correo electrónico registrados por los miembros: Una lista de dominios de correo electrónico registrados por los miembros de su consorcio
Registros por subdominio miembro: una lista de subdominios que están conectados a sus consorcios y cuántos ORCID los registros están asociados con ellos. Tenga en cuenta que es posible que esta cantidad de registros no coincida con la cantidad total de registros con su dominio de correo electrónico. Esto podría deberse a que no todos los dominios de correo electrónico registrados contra los miembros de su consorcio terminarán en su dominio nacional.
Registros activos con dominio nacional: Número de registros activos (registrados o actualizados en los últimos 365 días) con dominio de correo electrónico nacional
Registros que agregan dominio de correo electrónico por año: Un gráfico que muestra la cantidad de registros agregados por cada dominio de correo electrónico.
Elementos agregados por año por integración:Un gráfico que muestra cuántos artículos se han agregado desglosados por año y miembro en sus consorcios.
Registros actualizados con obras: El número de registros que han tenido al menos un trabajo agregado por una integración
Total de obras añadidas: El número total de obras añadidas por tus integraciones
Tipos de trabajos añadidos: Un porcentaje de la cantidad de cada tipo de trabajo que se ha agregado, por ejemplo, artículo de revista, preimpresión
Registros actualizados con revisiones por pares: El número de registros que han tenido al menos una revisión por pares agregada por una integración
Total de revisiones por pares añadidas: El número total de revisiones de pares agregadas por sus integraciones
Registros actualizados con financiación: El número de registros que tienen al menos un financiamiento agregado por una integración
Financiación total añadida: El número total de fondos agregados por sus integraciones
Registros actualizados con recursos de investigación: El número de registros que tienen al menos un recurso de investigación agregado por una integración
Registros actualizados con sitios web y enlaces sociales:La cantidad de registros que tienen al menos un sitio web y un enlace social agregado por una integración
Registros actualizados con identificadores personales: El número de registros que tienen al menos un identificador personal agregado por una integración
solicite solicitar credenciales de API de miembro de sandbox para construir y probar su aplicación. Estas credenciales le permiten realizar llamadas a la API de miembro premium de Sandbox para leer, escribir y actualizar. ORCID registros. El acceso al entorno de prueba de la caja de arena está disponible de forma gratuita para cualquier persona, incluso si no es un ORCID organización miembro.
Note: Si está utilizando un ORCID sistema de proveedor de servicios certificado que ya admite ORCID, no necesita registrarse para obtener las credenciales de la API de sandbox a menos que desee probar la ORCID funcionalidad de integración dentro del entorno Sandbox.
La caja de arena le permite crear cuentas de usuario de prueba y desarrollar su integración sin tener que preocuparse por afectar los datos en vivo (producción) ORCID Registro. El sandbox se comporta de la misma manera que la producción. ORCID Registro con algunas excepciones.
Creando una cuenta de prueba
Para probar el ORCID API y llamadas API, como leer y agregar información a un ORCID registro, también necesitará crear una prueba ORCID grabar en la caja de arena. Esto se puede hacer a través de la interfaz de usuario, al igual que en la producción. ORCID Registro. Ir https://sandbox.orcid.org/register y registrarse para una cuenta.
Direcciones de correo electrónico del remitente
El servidor sandbox solo envía correos electrónicos a Mailinator (@mailinator.com) direcciones de correo electrónico para no enviar spam a los servidores de correo sin querer. No recibirá un correo electrónico de verificación o una notificación de restablecimiento de contraseña a menos que use una dirección @mailinator.com, y se requiere verificación para realizar modificaciones manuales en los registros de la zona de pruebas. Obtenga más información sobre sus bandejas de entrada públicas de uso gratuito Si no desea utilizar un Mailinator dirección, luego tome nota de su nombre de usuario y contraseña (ya que los usará para otorgar autorización a su aplicación durante la prueba) y contáctenos para solicitar ayuda con la verificación.
Mailinator es un servicio de correo electrónico que tiene un servicio público gratuito y un servicio privado de pago. Para la prueba puede utilizar el servicio público completamente gratuito. Más información sobre sus niveles aquí.
Mailinator es un servicio de terceros que no es administrado ni mantenido por ORCID. Le recomendamos que revise cómo funciona este servicio y sus limitaciones antes de utilizar estas direcciones.
Las integraciones deben almacenar más que solo ORCID registros. Su sistema deberá poder:
- Aceptar y almacenar ORCID iDs: Su sistema necesitará conocer el iD de las ORCID grabar para mostrar el iD y actualizarse correctamente. Guárdelo junto con la información del investigador que se devuelve en la respuesta del intercambio de tokens. Nuestra recomendación es almacenar el URI https completo: https://orcid.org/0000-0001-5727-2427.
- Aceptar y almacenar persistente tokens de acceso y actualizar tokens: Los tokens de acceso se pueden utilizar para leer y actualizar registros, así como para indicar que iD ha sido autenticado. Los tokens de acceso tienen una validez aproximada de 20 años o hasta que el usuario los revoque. También le recomendamos guardar el alcance del token, caducidad del token y actualizar tokens. Los tokens de actualización se pueden utilizar para crear nuevos tokens de acceso con el mismo alcance o uno limitado si es necesario. Almacene los datos del token de acceso junto con la información del investigador.
- Aceptar y almacenar poner códigos : Cada elemento que agregas al ORCID El registro será devuelto con un código put por el ORCID API. Guarde este código de colocación de 6 dígitos junto con el elemento en su sistema; así identificará qué elemento debe leerse, actualizarse o eliminarse.
- Proporcione mensajes de error y un contacto de soporte cuando una interacción no sea la esperada.
Deberá completar el formulario para registrar una solicitud de cliente. A continuación se muestra una descripción general rápida de los campos solicitados:
Nombre de la organización: Tu ORCID nombre de la organización miembro
Dirección de correo electrónico de contacto principal para credenciales: Usaremos esta dirección de correo electrónico para enviarle las credenciales en un correo electrónico cifrado y para comunicarnos con usted si surge alguna pregunta o error con su integración.
Correo electrónico secundario para contraseña: Una dirección de correo electrónico a la que podemos enviar su contraseña de correo electrónico cifrada.
Nombre de su cliente: Esta sera tu ORCID nombre de la organización miembro. Si tiene más de una integración, agregaremos la aplicación al nombre.
URL de la página de inicio de su aplicación: Se muestra como un enlace en la lista de organizaciones confiables dentro de los usuarios. ORCID página de partes de confianza. Debe ser un enlace a su organización o a la página principal de su aplicación.
Breve descripción de su aplicación cliente: Este texto se mostrará en la pantalla de autorización con el icono del signo de interrogación a sus usuarios de integración. Se requiere una breve descripción de su integración.
Redirigir URI: Una vez que el usuario haya autorizado su aplicación, será devuelto a un URI que especifique. Debe proporcionar estos URI por adelantado o sus usuarios de integración experimentarán un error.
- Solo se aceptan URI de HTTPS.
- Los dominios registrados deben coincidir exactamente con los dominios utilizados, incluidos los subdominios.
- Registre todos los URI de redirección completos cuando sea posible.
- ¿Se requieren más de 5 URI de redirección? Indique esto en las Notas para ORCID de los empleados.
Notas para ORCID personal: Utilice este campo para permitir ORCID El personal sabe algo adicional sobre su solicitud o su integración.
Hay una serie de requisitos que esperamos que cumplan todas las integraciones de miembros. La ORCID El equipo se asegurará de que se cumplan estos requisitos como parte del proceso de revisión de la integración.
- Usa OAuth autenticar ORCID iDs (no permitir que los usuarios busquen o escriban ORCID ID.)
- Presente la pantalla de autorización de OAuth de acuerdo con nuestra orientaciones
- Incluir un ORCID botón o enlace de marca en su sitio para iniciar la autenticación del iD.
- Utilice HTTPS para los URI de redireccionamiento de su sitio y en ORCID Llamadas API
- Acepte y almacene todos los datos devueltos en el intercambio de tokens junto con los datos del usuario en su sistema
- Use apropiado alcances y métodos de solicitud (por ejemplo, llamadas POST para agregar nueva información y llamadas PUT para actualizar la información existente)
- Mostrar públicamente el autenticado ORCID iDs. Las identificaciones deben mostrarse después de nuestra marca registrada y iD mostrar las pautas.
- No solicitar a los usuarios que cambien la configuración de visibilidad de los elementos de su ORCID registro para utilizar su integración.
Recomendamos que los desarrolladores prueben la API pública en el servidor de pruebas sandbox antes de utilizar la versión de producción. A continuación se detallan los pasos sobre cómo registrarse para obtener credenciales de API públicas tanto en el entorno Sandbox como en el de producción.
- Accede a tu ORCID grabar:
Servidor de producción: https://orcid.org/signin
Servidor de pruebas sandbox: https://sandbox.orcid.org/signin - Haga clic en su nombre en la esquina superior derecha
- Haga clic en Herramientas para desarrolladores». desde la opción de menú
Nota: Para acceder a las Herramientas para desarrolladores, debe verificar su dirección de correo electrónico. Si aún no ha verificado su dirección de correo electrónico, se le pedirá que lo haga antes de poder registrarse para las credenciales de la API pública. - Lea y acepte el 'ORCID Condiciones de servicio para clientes públicos
- Haga clic en "Registrarse para ORCID botón de credenciales de API públicas”.
Completar el formulario de detalles de la solicitud
- Una vez que se haya registrado para obtener sus Credenciales de API pública, se le redirigirá a las Herramientas para desarrolladores (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- Debe completar el formulario de detalles de la solicitud presentado para registrar una nueva solicitud.
- Nombre: El nombre de su aplicación. Esto se mostrará a los usuarios cuando otorguen permiso a su aplicación para obtener su ORCID iD, y se mostrará en su Lista de organizaciones de confianza. Recomendamos utilizar el nombre de su organización o servicio (por ejemplo, el nombre de una revista).
- URL de la aplicación: El sitio web que el usuario puede visitar para obtener más información sobre su aplicación. Esto también se mostrará en su Lista de organizaciones de confianza.
- Descripción de la aplicación: Información sobre la aplicación que está desarrollando y cómo utilizará la aplicación del usuario. ORCID identificación. Esto se mostrará a los usuarios en la pantalla de OAuth.
Adición Redirigir URI
Una vez que el usuario haya autorizado su aplicación, será devuelto a un URI que especifique. Debe proporcionar estos URI por adelantado o sus usuarios de integración experimentarán un error.
- Ingrese su URI de redireccionamiento en el cuadro provisto
- Si necesita ingresar más de 1 URI de redireccionamiento, haga clic en 'Agregar otro URI de redireccionamiento'
Tengan en cuenta que:
- Solo URI de HTTPS son aceptados en producción
- Dominios registrados DEBE coincidir exactamente con los dominios utilizados, incluidos los subdominios
- Registre todos los URI de redirección completos cuando sea posible. Esta es la opción más segura y la que recomendamos. Para obtener más información sobre los URI de redireccionamiento, consulte nuestro Preguntas frecuentes sobre URI de redirección
Guardando tu aplicación
Una vez que haya completado el formulario de solicitud y agregado sus URI de redireccionamiento, puede guardar su solicitud.
- Haga clic en 'Guardar mi aplicación y generar mi ID de cliente y secreto'
Se le redirigirá a la página de herramientas para desarrolladores, que ahora incluirá sus credenciales de cliente de la API pública.
Actualización de sus credenciales
Hacer un cambio en la información de su solicitud es muy simple.
- Edite la información relevante y luego haga clic en 'Guardar solicitud'
Usa tus credenciales
Ahora que tiene sus credenciales, es hora de comenzar a usar el ORCID API pública!
Tenga en cuenta que podemos transferir sus credenciales a la API de miembro si se convierte en un ORCID miembro en el futuro.
Solicitud de organizaciones miembro ORCID Credenciales de API de miembro en el servidor de producción (en vivo) completando el Formulario de solicitud de cliente de API de miembro de producción. Antes de emitir las credenciales de API de miembro de producción, ORCID El equipo de compromiso/líder de consorcio revisará una demostración de su integración en el ORCID salvadera. Esto nos da la oportunidad de ver las excelentes integraciones que ha creado y ofrecer mejoras en el flujo de trabajo, así como verificar que todas las integraciones cumplan con nuestras mejores prácticas y requisitos mínimos para el lanzamiento.
Para proporcionar una demostración de su sistema, deberá configurar una integración de trabajo con el ORCID caja de arena que el ORCID el equipo puede obtener una vista previa. Hay algunas formas de compartir su integración de sandbox de trabajo:
- Recomendado: Demo en vivo: Contáctenos para programar una demostración en vivo. Le proporcionaremos un software para reuniones que le permitirá compartir su pantalla para que pueda demostrar su integración.
- Sitio de prueba: Si su sitio de desarrollo es público, envíanos la URL junto con las credenciales de prueba (si es necesario) para acceder a su sistema e instrucciones que describen cómo utilizar las ORCID características. Proporcione documentación adicional para verificar lo que no podríamos ver desde el extremo del usuario, por ejemplo, la versión de API utilizada, qué datos almacena su sistema, etc.
- Screencast o capturas de pantalla:Envía una grabación o un conjunto de capturas de pantalla con descripciones que explican y demuestran claramente cómo funciona su integración en cada paso, incluido qué sucede si un usuario niega el acceso o desconecta su identificación. Asegúrese de proporcionar documentación adicional para verificar cualquier cosa que no podamos ver desde el lado del usuario, como la versión de API utilizada y cómo se almacenan los datos.
Asistentes de búsqueda y enlace son integraciones que se pueden utilizar para importar elementos (principalmente obras) en el ORCID Registro. Deben someterse a pruebas entre el integrador y ORCID antes de que puedan publicarse en el entorno de registro de producción.
Dependiendo de sus respuestas a las siguientes preguntas, su integración puede ser una candidata adecuada para la búsqueda y el enlace; comuníquese con nosotros para discutir esto más a fondo antes de comenzar a desarrollar un asistente de búsqueda y enlace:
- ¿Cuál es el público objetivo del asistente? Por ejemplo, autores, revisores o solicitantes de subvenciones a nivel nacional, disciplinario o global.
- Aproximadamente, ¿qué tan grande es la audiencia esperada?
- ¿Servirá a una población que actualmente no cuenta con los servicios de los magos existentes? Por ejemplo, contribuciones de investigación en un idioma o disciplina específicos, o que sean de un tipo novedoso.
- ¿Cómo se asegurará de que el asistente proporcione una buena experiencia de usuario?
- ¿Qué apoyo al usuario brindará?
- ¿Hay, o habrá, una ORCID persona de contacto en su organización, como un gerente de producto, para el asistente?
- ¿Cómo se asegurará de que ORCID ¿Las identificaciones están autenticadas?
- ¿Ingerirá, o lo hará, y exhibirá ORCID iDs en su plataforma?
- ¿La búsqueda de su plataforma está habilitada por iDs?
Consulta nuestra Flujo de trabajo de búsqueda y enlace para obtener más información.
Los webhooks permiten a los miembros premium 'mirar' ORCID registros y ser notificado de cualquier cambio.
Usando la API y las credenciales de cliente de miembro premium, los miembros premium pueden registrar una URL de devolución de llamada para cada autenticado ORCID iD que desean rastrear. El ORCID El titular del registro no tiene que otorgar a la organización un permiso específico para registrar la URL, pero el intercambio de datos real se basa en los niveles de privacidad establecidos por el ORCID iD poseedor.
Con esto en su lugar ORCID notificará esa URL especificada mediante el envío de una solicitud cuando haya cambios en el ORCID registro.
Para obtener / acceso de lectura limitado, debe pedir permiso al investigador. Haz esto usando OAuth. Específicamente, "OAuth de 3 patas".
Para obtener más información, consulte nuestro Tutorial de API: leer datos en un ORCID grabar
Cualquiera con credenciales de API pública o miembro puede recibir una / read-public token de acceso. Para obtener un token, realiza una llamada al ORCID Punto final del token de API.
Este proceso a menudo se denomina flujo de OAuth de credenciales de cliente u OAuth de 2 pasos.
Un ejemplo de llamada para obtener un token de acceso para leer datos públicos en la caja de arena: reemplace los marcadores de posición con sus credenciales (asegúrese de eliminar los corchetes.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
A continuación, se le devolverá un token de acceso similar al siguiente. El token devuelto es de larga duración (no caduca durante aproximadamente 20 años) y se puede usar varias veces para recuperar datos públicos de ORCID Records.
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
Nota: Todos los tokens con el alcance / authenticate ahora también tienen el alcance / read-public incluido. Si usa solo el alcance / authenticate, puede usar los tokens de acceso almacenados para leer datos públicos sin necesidad de volver a obtener un token de acceso.
Los integradores que utilizan la API miembro pueden utilizar la / read-public alcance para leer ORCID resúmenes de registros.
Al solicitar permiso para interactuar con un ORCID registro del usuario, usted especifica uno o más 'ámbitos'. Cada alcance le permite hacer ciertas cosas, como leer el registro o actualizar una sección en particular.
3 patas se refiere a los tres actores involucrados en la obtención del permiso de un usuario; ORCID, su sistema y el propio usuario.
/autenticar
Este alcance se utiliza para recopilar el ORCID iD y leer información pública en el registro solamente. Todos los demás ámbitos de 3 patas incluyen el permiso de autenticación, por lo que este ámbito se puede omitir si se solicita cualquier otro acceso. Este alcance está disponible en la API pública o miembro.
/ read-limited (solo miembro API)
Este alcance se utiliza para obtener acceso para leer elementos públicos y de visibilidad limitada en un ORCID registro. Este alcance solo está disponible en la API de miembros.
/ actividades / actualización (solo API para miembros)
Este alcance se utiliza para escribir, actualizar y eliminar elementos en las secciones de afiliación, financiación, trabajos, actividades profesionales, recursos de investigación y revisión por pares de un ORCID registro. Este alcance solo está disponible en la API de miembros.
/ person / update (solo API para miembros)
Este alcance se utiliza para escribir, actualizar y eliminar elementos en las secciones de otros nombres, palabras clave, países, URL de investigadores, sitios web e identificadores externos personales del registro. Este alcance solo está disponible en la API de miembros.
abierto
Este alcance lo utilizan los integradores de OpenID cuando se requiere un id_token. Cuando se incluye el alcance de openid, el Registro devolverá un id_token dentro de la respuesta del token y otorgará permiso al cliente para acceder al punto final de información del usuario para ese usuario. Este alcance está disponible en la API pública y para miembros.
Tenga en cuenta que el alcance 'openid' no comienza con un '/' como el otro ORCID Ámbitos de API. Esto se debe a que el alcance 'openid' no está definido por ORCID, pero en su lugar está definido por la especificación OpenID Connect. Por favor vea nuestro Documentación de OpenID para obtener más información.
Múltiples alcances
Se pueden solicitar múltiples alcances en una sola interacción enumerando los alcances en la URL de autenticación con un espacio codificado entre cada uno, como alcance = / lectura limitada% 20 / actividades / actualización% 20 / persona / actualización
Acceso completo
Si desea acceso completo para leer y editar un registro, incluya tres ámbitos en su URL de autenticación: / lectura limitada, / actividades / actualización y / persona / actualización. En la URL aparecerían como scope = / read-limited% 20 / activities / update% 20 / person / update
Ámbitos de 2 patas (credencial de cliente)
Para algunas actividades, no es necesario pedir permiso al usuario. Los ámbitos de OAuth de dos patas se solicitan directamente desde el ORCID API y no requieren que el investigador otorgue permiso. Los tokens con estos alcances son válidos durante 20 años y se pueden reutilizar
/ read-public
Este alcance se utiliza para leer información pública en un solo ORCID identificación, buscar ORCID registros o para leer información resumida (solo API para miembros). Este alcance está disponible en la API pública o para miembros.
/ webhook
Este alcance permite que una aplicación cliente registre un webhook en un ORCID registro, para recibir notificaciones cuando se actualiza un registro. Este alcance está disponible para premium ORCID solo miembros.
ORCID las integraciones utilizan “OAuth de 3 patas” para autenticar a los usuarios y solicitar permiso para interactuar con sus registros. Cualquier integración puede solicitar permisos de lectura utilizando la API pública. ORCID los miembros pueden usar la API para miembros para solicitar permisos de actualización. Funciona así:
- Creas un enlace especial
- Cuando se hace clic, se envía al usuario a ORCID
- ORCID pide al usuario que inicie sesión
- ORCID pide al usuario que otorgue permiso a su aplicación
- ORCID envía al usuario de regreso a su sistema con un código de autorización
- Su sistema intercambia ese código por un token de acceso
La URL de autorización personalizada incluye la información de su cliente, así como los 'alcances' que especifican las áreas específicas de su registro a las que desea acceder. Después de iniciar sesión, el usuario autoriza la conexión con su sistema y regresa a su página de inicio junto con un código de autorización. Este código se utiliza luego para obtener su ORCID iD junto con un token de acceso válido para los ámbitos solicitados.
Crea tu enlace de autorización especificando el ID de cliente de tus credenciales de API y la página de destino asociada (URI de redireccionamiento). Elige qué permisos solicitar configurando el parámetro de alcance.
El siguiente ejemplo solicita permiso para leer datos de acceso limitado en el ORCID Servidor de prueba sandbox. En el mundo real, muestra este enlace en su sitio web o lo incluye en un correo electrónico cuando solicita al usuario que se autentique y autorice. Sin embargo, para fines de prueba, simplemente puede pegarlo en su navegador web. Reemplace los datos entre corchetes con la información de su cliente y asegúrese de eliminar los corchetes.
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
Cuando el usuario haya hecho clic en el enlace, haya iniciado sesión en ORCID y se les conceden permisos, se les redirige a su sitio, así:
https://[Your landing page]?code=Q70Y3A
Debe intercambiar inmediatamente el código de autorización por el ORCID iD y token de acceso. El código de autorización caduca con el uso. La solicitud se ve así y no se puede hacer en un navegador web, debe ser realizado por su servidor.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID luego devolverá el autenticado del investigador ORCID iD y un token de acceso en formato JSON:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
Los tokens de acceso tienen una larga vida de forma predeterminada y caducan 20 años después de su emisión. El token se puede usar varias veces antes de que caduque.
Usa el token de acceso
Los tokens de acceso de 3 patas están vinculados a ORCID registro. Para usarlos, debe incluirlos en las solicitudes de API que realice para leer o actualizar ese registro.
Usuarios puede cambiar su idioma de visualización por su cuenta en cualquier momento. Están disponibles las siguientes configuraciones de idioma:
Idioma | Código |
عربى (árabe) | ar |
čeština (checo) | cs |
Inglés | en |
Español (Español) | es |
Français (French) | fr |
Deutsch (alemán) | de |
Italiano (italiano) | it |
日本語 (japonés) | ja |
한국어 (coreano) | ko |
Polski (polaco) | pl |
Português (Portugués) | pt |
Русский (ruso) | ru |
Türkçe (turco) | tr |
简体 中文 (chino simplificado) | zh_CN |
繁體 中文 (chino tradicional) | zh_TW |
Si le preocupa que varios usuarios estén en la misma máquina y no cierren sesión entre sesiones, puede obligarlos a volver a autenticarse durante el proceso de OAuth. Simplemente incluye prompt=login
en la solicitud de OAuth. También puede establecer un max_age en segundos para obligar a los usuarios a volver a autenticarse si su sesión supera una determinada duración. Ver nuestro Documentación de OpenID Connect para obtener más información.
Implicit OAuth es una versión más ligera de OAuth diseñada para ser utilizada por sistemas que no tienen o no quieren utilizar componentes del lado del servidor. OAuth implícito se puede implementar completamente en el navegador usando solo javascript. Está disponible para socios y no socios y funciona así:
- Creas un enlace especial
- Cuando se hace clic, se envía al usuario a ORCID
- ORCID pide al usuario que firme i
- ORCID pide al usuario que otorgue permiso a su aplicación
- ORCID envía al usuario de vuelta a su sistema con su ORCID iD, un token de acceso y un token de identificación.
- Su sistema extrae y almacena los datos autenticados. ORCID iD de la respuesta.
Por motivos de seguridad, al utilizar OAuth implícito, ORCID no devolverá tokens de acceso con permisos de actualización.
Flujo implícito
El flujo implícito está diseñado para que los clientes no necesiten usar su clave secreta para iniciar ORCID iniciar sesión. La seguridad se aplica restringiendo a los clientes a sus redirect_urls registrados. Este menor nivel de seguridad significa que ORCID solo admite los ámbitos / authenticate y openid cuando se usa el flujo implícito. Los tokens también son de corta duración, con una vida útil de 10 minutos. Este flujo se recomienda para aplicaciones del lado del cliente que no tienen acceso a un servidor back-end, por ejemplo, aplicaciones telefónicas o aplicaciones web javascript de una sola página.
https://localhost/#access_token=24c11342-f5da-4cf9-94a4-f8a72a30da00&token_type=bearer&expires_in=599&tokenVersion=1&persistent=false&id_token=eyJraWQiOiJxYS1vcmNpZC1vcmctcjlhZmw3cWY2aG2c5bmdzenU1bnQ3Z3pmMGVhNmkiLCJhbGciOiJSUzI1NiJ9.eyJhdF9oYXNoIjoiMW52bXZBbVdwaVd0Z3ZKZW1DQmVYUSIsImF1ZCI6IkFQUC02TEtJSjNJNUIxQzRZSVFQIiwic3ViIjoiMDAwMC0wMDAyLTUwNjItMjIwOSIsImF1dGhfdGltZSI6MTUwNTk4Nzg2MiwiaXNzIjoiaHR0cHM6XC9cL29yY2lkLm9yZyIsIm5hbWUiOiJNciBDcmVkaXQgTmFtZSIsImV4cCI6MTUwNTk4ODQ2MywiZ2l2ZW5fbmFtZSI6IlRvbSIsImlhdCI6MTUwNTk4Nzg2Mywibm9uY2UiOiJ3aGF0ZXZlciIsImZhbWlseV9uYW1lIjoiRGVtIiwianRpIjoiY2U0YzlmNWUtNTBkNC00ZjhiLTliYzItMmViMTI0ZDVkNmNhIn0.hhhts2-4-ibjXPW6wEsFRaNqV_A-vTz2JFloYn7mS1jzQt3xuHiSaSIiXg3rpnt1RojF_yhcvE9Xe4SOtYimxxVycpjcm8yT_-7lUSrc46UCt9qW6gV7L7KQyKDjNl23wVwIifpRD2JSnx6WbuC0GhAxB5-2ynj6EbeEEcYjAy2tNwG-wcVlnfJLyddYDe8AI_RFhq7HrY4OByA91hiYvHzZ8VzoRW1s4CTCFurA7DoyQfCbeSxdfBuDQbjAzXuZB5-jD1k3WnjqVHrof1LHEPTFV4GQV-pDRmkUwspsPYxsJyKpKWSG_ONk57E_Ba--RqEcE1ZNNDUYHXAtiRnM3w
Vea las reseñas de nuestros de documentación técnica para obtener más información.
Si ya existe un token de acceso activo con los mismos alcances que solicita su URL de autorización de OAuth, y el usuario ha iniciado sesión en su ORCID registro, no se les pedirá que vuelvan a otorgar la autorización. En su lugar, se llevarán directamente al URI de redireccionamiento. Si desea solicitar a un usuario que otorgue autorización cada vez que se conecta, utilice la Forzar el método de cierre de sesión
Se pueden utilizar todos o cualquiera de los parámetros:
Parámetro | Campo | Notas |
nombres dados | Nombre de pila | La acreditación Nombre de pila El campo se completará en el formulario de inscripción si una dirección de correo electrónico especificada o ORCID iD no coincide con el de un activo ORCID registro. |
apellidos | Apellido | La acreditación apellido El campo se completará en el formulario de inscripción si la dirección de correo electrónico especificada o ORCID iD no coincide con el de un activo ORCID registro. |
Correo electrónico | La acreditación correo electrónico/ORCID iD El campo se completará en el formulario de inicio de sesión si la dirección de correo electrónico especificada se encuentra en nuestro sistema y no es válida ORCID iD se especifica. email El campo se completará en el formulario de inscripción si la dirección de correo electrónico especificada se encuentra en nuestro sistema y no es válida ORCID iD La dirección de correo electrónico debe ser URL codificada, incluido el cambio de "@" a "% 40". Si conoce el usuario ORCID iD y dirección de correo electrónico, sugerimos only proporcionando el ORCID iD en el parámetro orcid. | |
orcido | ORCID iD | La acreditación correo electrónico/ORCID iD El campo se completará en el formulario de inicio de sesión si el especificado ORCID iD se encuentra en nuestro sistema. formulario de inscripción de lo contrario, se mostrará si el especificado ORCID iD no se encuentra en nuestro sistema. ORCID iD debe estar en el Formato de 16 dígitos del iD URI. |
Un ejemplo de URL con estos parámetros es
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYIn&response_type=coden&scope=/authenticaten&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplaygroundn&family_names=Finn&given_names=Huckleberry&email=huckle%40mailinator.com
OpenID Connect 1.0 es una capa de identidad simple sobre el protocolo OAuth 2.0. Complementa los flujos de autenticación de OAuth existentes y proporciona información sobre los usuarios a los clientes de una manera bien descrita.
OpenID connect es una forma estandarizada de implementar OAuth y compartir información sobre usuarios autenticados. Ahora será posible configurar los servicios para usar ORCID "listo para usar" junto con otros proveedores de conexión OpenID que cumplen con los estándares. OpenID connect también proporciona tokens de identificación compartibles, que son objetos firmados que pueden demostrar que un usuario se autenticó mediante ORCID en un momento específico. Los elementos de la interfaz de usuario pueden utilizar estos tokens para mantener las sesiones de usuario.
ORCID admite el perfil de conformidad del proveedor de OpenID básico, que es una extensión del flujo del código de autorización de OAuth. ORCID también admite el flujo de token implícito para los ámbitos "/ authenticate" y "openid".
Esto significa que ORCID:
- Incorpora tokens de identificación firmados dentro de las respuestas de token para los códigos de autorización generados con el alcance 'openid'
- Admite el flujo implícito cuando se utilizan 'token' o 'token id_token' response_types y el alcance 'openid'.
- Admite los parámetros 'prompt', 'nonce' y 'max_age' para solicitudes de autorización que incluyen el alcance 'openid'.
- Admite puntos finales de información de usuario y descubrimiento de Openid Connect
- Admite el campo 'amr' para integradores que utilizan la API de miembro para solicitudes de autorización que incluyen el alcance 'openid'. Esto se puede utilizar para descubrir si un usuario se autenticó mediante la autenticación de dos factores.
Iniciar una autenticación OpenID Connect funciona de la misma manera que una autenticación OAuth normal. Todo lo que se requiere es que el cliente solicite el alcance 'openid'. Si está utilizando el alcance / authenticate, reemplácelo con openid, ya que authenticate y openid tienen la misma autorización, solo se debe usar uno u otro. Si está utilizando otros ámbitos, agregue openid a la lista de ámbitos solicitados. Cuando se incluye el alcance de openid, el Registro devolverá un id_token dentro de la respuesta del token y otorgará permiso al cliente para acceder al punto final de información del usuario para ese usuario.
Tenga en cuenta que el alcance 'openid' no comienza con un '/' como el otro ORCID Ámbitos de API. Esto se debe a que el alcance 'openid' no está definido por ORCID, pero en su lugar está definido por la especificación OpenID Connect.
Vea las reseñas de nuestros de documentación técnica para obtener más información.
¿Qué son los URI de redireccionamiento y cómo se utilizan?
Nuestro servicio de autenticación OAuth utiliza los URI de redirección como medida de seguridad. ORCID solo enviará usuarios autenticados a URI registrados por el cliente que solicita la autenticación. Esto evita que los servicios se suplanten entre sí.
Tenga en cuenta que solo URI de HTTPS son aceptados en producción. Puede probar usando HTTP URI, pero deberá registrarse URI de HTTPS cuando solicita credenciales de API de miembro de producción.
¿Cómo hacemos coincidir los URI de redirección?
- DEBE registrar subdominios como URI separados. https://anythingelse.thirdparty.com no funcionará.
- Se recomienda registrar todos los URI de redirección completos, incluida la ruta., es lo que hacen la mayoría de los terceros y es la opción más segura.
- Si la aplicación cliente está registrada con un URI de redireccionamiento que es solo el nombre del host, se puede usar cualquier URI de redireccionamiento en ese host.. Entonces, por ejemplo, si se registra el siguiente uri de redirección: https://thirdparty.com entonces todos los siguientes redirect_uris funcionarán:
- https://thirdparty.com/oauth/callback1
- https://thirdparty.com/callback2
- https://thirdparty.com/anything-else-as-long-as-the-host-is-the-same
Sin embargo, https://anythingelse.thirdparty.com no trabajará. También DEBE registrar subdominios como URI separados.
¿Qué sucede si mi URI de redirección es incorrecta?
Usuarios enviados para autenticarse en ORCID con URI de redireccionamiento incorrectos verá un mensaje de error similar a este:
Gestión de URI de redireccionamiento para miembros
Si está utilizando la API de miembro y necesita algún cambio en sus URI de redireccionamiento, comuníquese con nuestro Equipo de Compromiso
Gestión de URI de redirección para clientes públicos
Si está utilizando la API pública, deberá seguir los pasos a continuación para actualizar su lista de URI de redirección que están asociados con su ORCID ID de cliente de API pública. Puede hacerlo siguiendo los pasos a continuación:
- Inicia sesión en tu ORCID grabar
- Haga clic en su nombre en la esquina derecha
- Seleccionar herramientas de desarrollador
- Haga clic en el lápiz de edición junto al nombre del cliente
- Edite un URI de redireccionamiento existente o haga clic en 'Agregar otro URI de redireccionamiento' edite uno existente
- Una vez que haya realizado los cambios, debe hacer clic en el icono Guardar
Solo URI de HTTPS son aceptados en producción. Puede probar con URI de http, pero deberá registrar URI de HTTPS cuando solicite las credenciales de API de miembro de producción.
ORCID permite a los usuarios habilitar Autenticación de dos factores (2FA) en su ORCID cuenta. 2FA es una verificación de seguridad secundaria que se realiza durante el proceso de inicio de sesión. Proporciona una confirmación adicional de que el usuario es de hecho la persona que inicia sesión en un ORCID cuenta. Para obtener más información sobre cómo se puede configurar esto para los usuarios, consulte nuestro Artículo de KB.
Open ID Los integradores de conexión que usan la API miembro pueden verificar si el usuario ha iniciado sesión en su ORCID cuenta con 2FA habilitado como parte del proceso de OAuth. Esto puede permitir a los integradores miembros otorgar acceso a sus investigadores a sistemas de mayor seguridad.
ID de organización registrada – Esta sección muestra los ID de la organización que se han utilizado para generar los datos en el informe. Estas son las identificaciones que hemos registrado contra su ORCID afiliación.
Número de Registros Afiliados - El numero total de ORCID registros que tienen una afiliación pública (empleo, educación, calificaciones, membresía, servicios, puestos invitados y distinciones) dentro del registro de su organización. Tenga en cuenta que puede haber más dentro del registro que no tengan un ID de organización adjunto o que no tengan la configuración de visibilidad de "Todos".
Número de registros con afiliación vigente – El numero total de ORCID registros que tienen una afiliación pública actual dentro del registro de su organización. Una afiliación actual es una afiliación que no tiene una fecha de finalización completa. Tenga en cuenta que puede haber más dentro del registro que no tengan una ID de organización adjunta o que no tengan la configuración de visibilidad de "Todos".
Número de registros con afiliación laboral vigente – El numero total de ORCID registros que tienen una afiliación de empleo público actual dentro del registro de su organización. Una afiliación actual es una afiliación que no tiene una fecha de finalización completa. Tenga en cuenta que puede haber más dentro del registro que no tengan una ID de organización adjunta o que no tengan la configuración de visibilidad de "Todos"
Afiliaciones Totales – El número total de afiliaciones públicas dentro del registro para su organización. Esto incluye las afiliaciones actuales y pasadas. Tenga en cuenta que puede haber más afiliaciones dentro del registro que no tengan un ID de organización adjunto o que no tengan la configuración de visibilidad de "Todos".
Afiliaciones creadas con el tiempo – Un gráfico que muestra la cantidad de afiliaciones que se han agregado al registro a lo largo del tiempo. El gráfico está dividido por afiliaciones que su organización ha agregado y las afiliaciones que sus investigadores han agregado manualmente
Afiliaciones creadas a lo largo del tiempo por tipo – Un gráfico que muestra los tipos de afiliaciones que se han agregado a lo largo del tiempo.
Afiliaciones creadas a lo largo del tiempo por ORG ID – Un gráfico que muestra la cantidad de afiliaciones agregadas por ID de ORG a lo largo del tiempo.
ORCID proporciona un simple Widget de Java Script que se puede utilizar para obtener autenticado ORCID iD que utilizan OAuth con OpenID Connect.
Tenga en cuenta que el widget utiliza OAuth implícito, por lo que no recopila ningún permiso de escritura. Esto significa que no es adecuado para integraciones de miembros que deseen actualizar registros. Consulte nuestro tutorial para Agregar y actualizar datos en ORCID Records.
En acuerdo con nuestro compromiso con el control investigador de sus ORCID grabar, el titular del registro puede optar por revocar cualquier token de acceso en cualquier momento eliminándolo de los permisos en el Organización de confianzan lista en su página de Partes de confianza.
A partir de 2018, los investigadores solo pueden otorgar tokens de acceso de larga duración que duran 20 años a menos que el usuario revoque el permiso.
afiliado públicamente ORCID Registros - Una lista de los ORCID registros que tienen una afiliación pública a su organización. Las afiliaciones públicas son aquellas cuya visibilidad está configurada para “todos” en el registro. La lista contiene la ORCID iD, nombre, apellido y nombre de crédito
Empleado publico actualmente ORCID Archivos - Una lista de ORCID registros que tengan una afiliación de empleo público a su organización. Las afiliaciones públicas son aquellas cuya visibilidad está configurada para “todos” en el registro. La lista contiene la ORCID DNI, nombre, apellidos y fecha de inicio de afiliación
Afiliaciones Públicas con datos de afiliacion– Una lista de las afiliaciones públicas a su organización. La lista incluye ORCID iD, nombre de pila, apellido, tipo, cargo, departamento, fechas de inicio y finalización, fecha de adición a ORCID, fecha de última modificación de la afiliación, fuente, tipo de ID de organización y valor de ID de organización.
Todas las secciones de afiliación utilizan el mismo conjunto de metadatos en la API:
- Nombre de la organización:* El nombre de la organización al más alto nivel (por ejemplo, "Boston University" en lugar de "Boston University School of Medicine").
- Ciudad de la organización: * Ciudad donde tiene su sede la organización.
- Región de la organización: Región donde se encuentra la organización.
- País de la organización * el país de la organización. Esto debe llenarse con el código de país ISO 3166 Alpha-2 de dos letras.
- Identificación de la organización (ROR, GRID, Ringgold** o LEI):* Un identificador único para la organización y su origen. Recomendamos que se utilice el ID de la organización principal dentro de la afiliación y no de la división o el departamento.
- Rol / Título: El cargo que ocupa, o el título otorgado o por otorgar.
- Departamento: Cualquier subdivisión de la organización matriz.
- URL: Una URL a un recurso sobre la afiliación.
- Fecha de inicio: La fecha en que comenzó la relación entre el investigador y la organización (se puede especificar por año, mes y día).
- Fecha de finalización: La fecha en que terminó la relación entre el investigador y la organización (se puede especificar hasta año, mes y día)
- Un identificador persistente externo que describe la afiliación: Un identificador único para la afirmación de afiliación real.
*Indica un campo obligatorio.
**Aunque los identificadores Ringgold todavía existen dentro del ORCID registro, a partir del 1 de agosto de 2023, ORCID ya no recibe actualizaciones de la base de datos de identificadores de organizaciones RINGGOLD utilizada por nuestro Registro, ni podremos procesar ni utilizar los ID de RINGGOLD creados después de esa fecha. Vea nuestro Preguntas Frecuentes para más información.
Documentación técnica
Se puede encontrar un tutorial más detallado aquí.