Preguntas frecuentes sobre integración y API

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:

Tutorial de API: agregar y actualizar datos en un ORCID grabar

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.

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.

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.

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/

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.

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:

1. 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. 
2. 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.
3. 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.

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 al cliente ID a la API de miembros no alterará la identificación del cliente, solo el secreto del cliente, y mantendrá 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:

1. Confirmación del cliente API pública ID para ser convertido
    
2. Que el contacto principal de la organización y el titular del registro del cliente API público actual ID estar 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.

3. Una fecha/hora para que ocurra la migración. Como parte de esta migración, actualizaremos el cliente ID y enviarle un nuevo secreto de cliente en un correo electrónico encriptado. Tenga en cuenta que una vez que actualicemos el cliente, su integración no funcionará hasta que actualice el secreto del cliente. Es por esto que necesitamos fijar una fecha y hora para que esto se haga y evitar molestias a 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 apiorcid.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.

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.

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.

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
• Haz Clic  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'

Ten 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 cliente ID 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.

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.

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.

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.

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:

1. 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. 
2. 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.
3. 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.

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.

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.
• Organización/Empresa ID (ROR, GRID, Ringgold** o LEI):* Un identificador único para la organización y su fuente. Recomendamos que la organización matriz ID se utiliza dentro de la afiliación y no en la división o 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

• 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

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.

• 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 grupo ID que se utiliza con fines de agregación: para artículos de revistas, el identificador predeterminado es el eISSN, que se completa automáticamente a través de 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ó. 

* 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.

• 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: EL 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.
• Organización/Empresa ID (ROR, GRID, Ringgold** o LEI):* Un identificador único para la organización y su fuente. Recomendamos que la organización matriz ID se utiliza dentro de la afiliación y no en la división o 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.
• Organización/Empresa ID (ROR, GRID, RInggold** o LEI):* Un identificador único para la organización y su fuente. Recomendamos que la organización matriz ID se utiliza dentro de la afiliación y no en la división o 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.
• Organización/Empresa ID (ROR, Ringgold**, GRID o LEI):* Un identificador único para la organización y su fuente. Recomendamos que la organización matriz ID se utiliza dentro de la afiliación y no en la división o 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.

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:

1. 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
2. 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, mediante los siguientes elementos:

1. 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
2. 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:

• Vías de garantía de afirmación: ¿qué son y por qué son importantes?
• Planes para habilitar múltiples afirmaciones en el ORCID Registro

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.

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.

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.

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

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.

El campo colaborador en obras y financiación permite que las integraciones de miembros relacionen a los investigadores que han colaborado en un trabajo o son parte de un proyecto financiado. Tanto para financiación como para obras, es posible incluir el nombre del aportante. ORCID iD junto con el papel. Le sugerimos que agregue el colaborador ORCID iDs solo si ha autenticado el ORCID iD, o ha recopilado el ORCID iD de una fuente que lo haya autentificado. Se pueden agregar múltiples roles. La secuencia de contribuyentes se utiliza para indicar en qué parte de la lista de contribuyentes deben aparecer los nombres del colaborador o de otros contribuyentes. Las 2 opciones que apoyamos son:

• 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.

TERM (valor de UI)	Enlance (Valor API)
Conceptualización	https://credit.niso.org/contributor-roles/conceptualization/
Curación de datos	https://credit.niso.org/contributor-roles/data-curation/
Análisis formal	https://credit.niso.org/contributor-roles/formal-analysis/
Adquisición de fondos	https://credit.niso.org/contributor-roles/funding-acquisition/
Investigación	https://credit.niso.org/contributor-roles/investigation/
Metodología	https://credit.niso.org/contributor-roles/methodology/
Administración de proyecto	https://credit.niso.org/contributor-roles/project-administration/
Recursos	https://credit.niso.org/contributor-roles/resources/
Software	https://credit.niso.org/contributor-roles/software/
Supervisión	https://credit.niso.org/contributor-roles/supervision/
Validación	https://credit.niso.org/contributor-roles/validation/
Visualización	https://credit.niso.org/contributor-roles/visualization/
Redacción - borrador original	https://credit.niso.org/contributor-roles/writing-original-draft/
Redacción-revisión y edición	https://credit.niso.org/contributor-roles/writing-review-editing/

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

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.

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/

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.

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.

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
• La organización del proveedor ID (por ejemplo, ROR ID)
• 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 ID persistente de calificación. Esto debería estar vinculado a una versión en línea del certificado de calificación. Este podría ser un único existente ID o simplemente un URI.

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.

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

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.

Cree el enlace de autorización y obtenga un código de autorización

Usted construye su enlace de autorización especificando el cliente de sus credenciales de API ID y la página de destino asociada (redireccionamiento URI). Usted 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

Cambie el código de autorización por un ORCID iD y token de acceso

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.

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.

Ámbitos de 3 patas (código de autorización)

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.

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.

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

Se pueden utilizar todos o cualquiera de los parámetros:

Parámetro	Campo	Notas
nombres dados	Nombre de pila	EL 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	EL 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.
email	Correo electrónico	EL 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 existentes en la orcid parámetro.
orcid	ORCID iD	EL 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

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

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 id simbólico.
• 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.

¿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.

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 compartible ID tokens, que son objetos firmados que pueden probar que un usuario está autenticado usando 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:

• Inserciones firmadas id tokens dentro de las respuestas de token para 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.

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.

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.

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.

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 al cliente ID a la API de miembros no alterará la identificación del cliente, solo el secreto del cliente, y mantendrá 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:

1. Confirmación del cliente API pública ID para ser convertido
    
2. Que el contacto principal de la organización y el titular del registro del cliente API público actual ID estar 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.

3. Una fecha/hora para que ocurra la migración. Como parte de esta migración, actualizaremos el cliente ID y enviarle un nuevo secreto de cliente en un correo electrónico encriptado. Tenga en cuenta que una vez que actualicemos el cliente, su integración no funcionará hasta que actualice el secreto del cliente. Es por esto que necesitamos fijar una fecha y hora para que esto se haga y evitar molestias a 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 apiorcid.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.

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.

EL 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
/Email	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

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:

Tutorial de API: agregar y actualizar datos en un ORCID grabar

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.

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.

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:

• Archivos XML de ejemplo
• El XSD para todas las secciones del 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.

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 / read-limited usar en su lugar / lectura limitada
• /orcid-trabajos / lectura-limitada usar en su lugar / lectura limitada
• /orcid-bio / lectura-limiteusaría en su lugar / lectura limitada
• /orcid-trabaja / crea usar en su lugar / actividades / actualización
• /orcid-trabajos / 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

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.

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

Llamada de ejemplo: GitHub

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ó.

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.

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

Llamadas de ejemplo: GitHub

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.

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>

Ejemplo de llamada: Github

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.

EL 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:	Sandbox: https: //pub.sandbox.orcid.org Producción: https: // pub.orcid.org	Sandbox: 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 la zona de pruebas 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

Llamada de ejemplo: GitHub

EL 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.
email	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	EL 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	EL 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	EL 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	EL 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
orcid	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

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

EL 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:

• cURL
• apartado Postal
• wget
• lanzarlo
• Zona de juegos de Google OAuth 2.0
• Pavonearse: API miembro (caja de arena), API pública (caja de arena)

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 grabe y luego agregue ‚√∫/webhook‚√π y la URL a la que desea llamar. Entonces debería verse como 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 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

EL 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.

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 de 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.

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.

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.

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.

Consulte la ORCID página de sistemas habilitados por proveedores para editores para obtener la información más actualizada

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"}

¡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.

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í.

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. 

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 ponerte en contacto con nosotros.

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.

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.

Vea el vídeo en YouTube

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 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 ponerte 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 sección final de los informes contiene información sobre los investigadores que utilizaron su integración desglosada por el país desde el que accedieron a su integración. Estos datos se derivan de la dirección IP de un investigador o su ubicación geográfica. ID (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, ponerte en contacto con nosotros.

EL 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 usando el nombre de la afiliación o el ROR único de la organización ID o ID DE RED. (Puede encontrar el GRID de su organización ID in GRID o tu ROR ID existentes en la 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 GRID ID 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 @orcid.org dirección de correo electrónico:

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:

orcid
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")

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.

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.

Si cree que los datos que se muestran en su informe son inexactos, por favor ponerte en contacto con nosotros con tantos detalles como sea posible y nuestro equipo de participación investigará.

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.

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

Hemos compilado una guía para guiarlo a través de cada sección de los informes. La guía se puede encontrar aquí.

Los datos que se utilizan para producir los informes de miembros e integración se actualizan a diario.