Julio marca el quinto mes desde que lanzamos ORCID API v2.0y nos complace informar que muchos usuarios de la API pública y para miembros ya se han actualizado o están en proceso de hacerlo. Para animar a aquellos de ustedes que aún no han comenzado su actualización, nos gustaría destacar algunas de las características de la v2.0 que simplificará sus flujos de trabajo, reducirá el tamaño de los archivos de transferencia y hará que su ORCID la integración funciona mejor para usted y sus usuarios por igual.
Menos alcances, menos confusión
Nuestra antigua API le permitía solicitar una gran cantidad de permisos de los usuarios: permiso para crear elementos en una sección, leer esa misma sección y actualizarla. Solicitar permisos separados para cada sección resultó en una lista de solicitudes que confundieron a los usuarios.
En API v2.0 tenemos consolidado nuestros alcances en tres, que le permiten solicitar acceso de lectura (limitado) y actualización a todas las secciones del ORCID registro.
¿Todavía tienes esos tokens en los permisos anteriores? No se preocupe, seguirán funcionando en los niveles de acceso para los que se emitieron originalmente. Pero es posible que desee crear un flujo de trabajo para solicitar que los usuarios actualicen sus permisos si su sistema actualizado tiene nuevas funciones que implican acceso a otras secciones de su registro.
Leer y actualizar por artículo
Con versiones anteriores de la API, si su sistema necesitaba agregar un nuevo trabajo único en un registro al que había agregado varios trabajos, entonces tenía que actualizar toda la sección de trabajos, incluido el nuevo trabajo y todos los trabajos agregados anteriormente. Como resultado, actualizar un solo elemento en un registro implicaba enviar un archivo potencialmente grande de otros elementos que no tenían cambios, o perder todos los elementos en esa sección, o incluso el registro completo.
v2.0 ha simplificado este proceso al gestionar artículos de forma individual. Tu sistema puede agregar una sola obra a una ORCID grabary luego edite o elimine ese único trabajo. Esto se hace implementando poner códigos para elementos individuales en el ORCID Registro. Por ejemplo, si su sistema agrega una nueva afiliación laboral a una ORCID registro, el ORCID La API devuelve un mensaje de confirmación junto con el código de transferencia que su sistema puede usar para actualizar o eliminar solo ese elemento. En general, solo se puede agregar, editar o eliminar un elemento a la vez en un ORCID registro. La única excepción son las obras., que para muchos investigadores constituyen la mayor parte de sus ORCID registro. API v2.0 permite que sus sistemas leer hasta 50 obras a la vez, y para sumar hasta 100 obras a la vez. La edición o eliminación de trabajos aún debe realizarse en base a elementos.
Los códigos de venta son retroactivos: a los elementos agregados en 1.2 y anteriores se les han asignado códigos de venta. Mientras trabaja para actualizar su sistema para la versión 2.0, recuerde agregar un campo para su código de colocación correspondiente. Puede consultar un ORCID record para obtener los códigos de colocación de cualquier elemento que su sistema haya agregado al Registro, y actualice su base de datos en consecuencia para que pueda actualizarlos en el futuro según sea necesario.
Leer registros más rápido
API v2.0, como la API anterior, permite que su sistema leer una sola sección o todo el registro en una sola llamada. Lo que devuelve no serán todos los datos de un registro, sino más bien una vista resumida de las tres secciones que tienden a ser las más grandes en ORCID registros: trabajos, financiación y revisiones por pares.
Ya sea que su sistema lea el registro completo o una sola sección, el vista de resumen de estas actividades se muestra. El resumen contiene información limitada: el resumen del trabajo, por ejemplo, devuelve solo el título del trabajo, el tipo, la fecha, sus identificadores únicos y su relación con el trabajo, el índice de visualización para cada versión del artículo (si hay varias versiones), la fuente (el usuario o cliente API) y el código de colocación correspondiente para cada versión del artículo.
Las vistas de resumen reducen el tamaño de los archivos y los tiempos de transferencia, lo que reduce la tensión potencial en nuestro sistema y el suyo, y hace que las actualizaciones sean más rápidas.
Y mucho más
Hay mucho más en la v2.0 por lo que estar feliz: soporte flexible para identificadores externos, adición de actividades de revisión por pares, agrupación más clara de múltiples versiones de actividades, mejores resultados de búsqueda de forma predeterminada y más.
¿Querer aprender más? ¡Únete a nosotros! Cada mes llevamos a cabo seminarios web en múltiples zonas horarias e idiomas, y durante el resto del año discutiremos la actualización a API v2.0. Consulte nuestros listados para el próximoo contáctenos para obtener más información.
¿Ya se actualizó a API v2.0? Háganos saber su experiencia!