Juillet marque le cinquième mois depuis notre sortie ORCID API v2.0, et nous sommes ravis d'annoncer que de nombreux utilisateurs de l'API publique et membre ont déjà mis à niveau ou sont en train de le faire. Pour encourager ceux d'entre vous qui n'ont pas encore commencé leur mise à niveau, nous aimerions souligner certaines des fonctionnalités de la v2.0 qui simplifiera vos flux de travail, réduira la taille des fichiers de transfert et rendra votre ORCID l'intégration fonctionne mieux pour vous et vos utilisateurs.
Moins de portées, moins de confusion
Notre ancienne API vous permettait de demander beaucoup de autorisations des utilisateurs: autorisation de créer des éléments dans une section, de lire cette même section et de la mettre à jour. La demande d'autorisations distinctes pour chaque section a entraîné une liste de demandes qui ont dérouté les utilisateurs.
Dans l'API v2.0, nous avons consolidé nos périmètres en trois, qui vous permettent de demander un accès en lecture (limité) et de mise à jour à toutes les sections du ORCID record.
Vous avez toujours ces jetons avec les anciennes autorisations ? Ne vous inquiétez pas, ils continueront de fonctionner aux niveaux d'accès pour lesquels ils ont été émis à l'origine. Mais vous souhaiterez peut-être créer un flux de travail pour demander aux utilisateurs d'actualiser leurs autorisations si votre système mis à niveau comporte de nouvelles fonctionnalités impliquant l'accès à d'autres sections de leur enregistrement.
Lire et mettre à jour par élément
À l'aide des versions précédentes de l'API, si votre système devait ajouter une nouvelle œuvre unique sur un enregistrement auquel vous aviez ajouté plusieurs œuvres, il devait alors mettre à jour toute la section des œuvres, y compris la nouvelle œuvre et toutes les œuvres précédemment ajoutées. En conséquence, la mise à jour d'un seul élément d'un enregistrement impliquait l'envoi d'un fichier potentiellement volumineux d'autres éléments qui n'avaient subi aucune modification, ou la perte de tous les éléments de cette section, voire de l'intégralité de l'enregistrement.
La v2.0 a simplifié ce processus en gestion des articles sur une base individuelle. Votre système peut ajouter une seule œuvre à un ORCID record, puis modifiez ou supprimez cette œuvre unique. Cela se fait en mettant en œuvre mettre des codes pour les articles individuels sur le ORCID Enregistrement. Par exemple, si votre système ajoute une nouvelle affiliation professionnelle à un ORCID enregistrer, le ORCID L'API renvoie un message de confirmation avec le code d'insertion que votre système peut utiliser pour mettre à jour ou supprimer cet élément uniquement. En général, un seul élément peut être ajouté, modifié ou supprimé à la fois sur un ORCID record. La seule exception est les travaux, qui pour de nombreux chercheurs constituent l'essentiel de leur ORCID enregistrer. L'API v2.0 permet à vos systèmes de lire jusqu'à 50 œuvres à la fois, et à ajouter jusqu'à 100 œuvres à la fois. L'édition ou la suppression d'œuvres doit toujours être effectuée par article.
Les codes de vente sont rétroactifs : les articles ajoutés dans la version 1.2 et antérieures ont tous reçu des codes de vente. Pendant que vous travaillez à la mise à niveau de votre système pour la v2.0, n'oubliez pas d'ajouter un champ pour son code put correspondant. Vous pouvez interroger un ORCID enregistrez pour obtenir les codes de mise de tous les éléments que votre système a ajoutés au registre, et mettez à jour votre base de données en conséquence afin que vous puissiez les mettre à jour à l'avenir si nécessaire.
Lire les enregistrements plus rapidement
L'API v2.0, comme l'API précédente, permet à votre système de lire une seule section ou l'intégralité du dossier en un seul appel. Ce qui renvoie, ce ne sont pas toutes les données d'un enregistrement, mais plutôt une vue récapitulative des trois sections qui ont tendance à être les plus grandes sur ORCID dossiers : travaux, financements et revues par les pairs.
Que votre système lise l'intégralité de l'enregistrement ou une seule section, le vue récapitulative de ces activités s'affiche. Le résumé contient des informations limitées : le résumé de l'œuvre, par exemple, ne renvoie que le titre de l'œuvre, le type, la date, ses identifiants uniques et leur relation avec l'œuvre, l'index d'affichage pour chaque version de l'ouvrage (s'il existe plusieurs versions), la source (l'utilisateur ou le client API) et le code put correspondant pour chaque version de l'élément.
Les vues récapitulatives réduisent la taille des fichiers et les temps de transfert, réduisant ainsi la pression potentielle sur notre système et le vôtre, et accélérant les mises à jour.
Et bien plus encore!
Il y a beaucoup plus dans la v2.0 pour être heureux: prise en charge flexible des identifiants externes, ajout d'activités d'examen par les pairs, regroupement plus clair de plusieurs versions d'activités, meilleurs résultats de recherche par défaut, etc.
Vous voulez en savoir plus ? Rejoignez-nous! Chaque mois, nous organisons des webinaires dans plusieurs fuseaux horaires et langues, et pour le reste de l'année, nous discuterons de la mise à niveau vers l'API v2.0. Consultez nos annonces pour le prochainou CONTACTEZ-NOUS pour en savoir plus.
Avez-vous déjà mis à niveau vers l'API v2.0 ? Faites nous part de votre expérience!