En tant qu'organisme de recherche, s'intégrant à ORCID est un moyen incroyablement puissant de soutenir les chercheurs qui vous sont connectés. Nous encourageons les intégrations avec le ORCID Le registre doit être bidirectionnel, afin que les systèmes institutionnels puissent à la fois pousser et extraire des données vers et depuis ORCID enregistrements. Au fur et à mesure que d'autres organisations avec lesquelles vos chercheurs interagissent ajoutent leurs données au ORCID Registre, leurs dossiers continueront d'accumuler davantage de données pouvant être réutilisées avec d'autres systèmes connectés au ORCID registre, y compris le vôtre.
Nous nous engageons à aider les organisations à s'intégrer au ORCID Registre, et plus tôt cette année, nous avons tenu le premier en direct du Je suis membre, et maintenant ? ! 2023 pour couvrir certaines informations de base sur les intégrations : ce qu'elles sont, les meilleures pratiques pour les utiliser et quelques options simples pour commencer à en développer une. Si vous l'avez manqué, nous vous encourageons à regarder l'enregistrement et lire notre article de blog compagnon.
Ce mois-ci, nous avons organisé la deuxième en direct de la série cette année - celui-ci sur la création d'intégrations personnalisées, qui est une option pour les organisations qui n'ont pas de systèmes de fournisseurs de services universitaires avec pré-construit ORCID fonctionnalités, ou qui ont des systèmes personnalisés qui ont été développés en interne. Bien que les intégrations personnalisées nécessitent plus de planification et de ressources pour se développer, notre API est basée sur des technologies d'API standard et familières.
Avec une intégration personnalisée, ORCID les organisations membres peuvent :
- Utilisez ORCID en tant que option de connexion pour les systèmes institutionnels
- Authentifiez-vous ORCID identifiants
- Lire les données des parties publiques et de confiance » ORCID Articles
- Écrire des données à ORCID Articles
- Configurer les notifications des webhooks pour synchroniser les systèmes avec ORCID (Remarque : il s'agit d'un avantage pour les membres Premium.)
Bien sûr, certaines exigences minimales sont nécessaires pour que les intégrations personnalisées fonctionnent avec vos systèmes, notamment :
- Utilisez HTTPS pour les URI de redirection de votre site et sur ORCID Appels API
- Accepter et stocker toutes les données renvoyées dans le échange de jetons avec les données de l'utilisateur dans votre système
- Utiliser le bon portée et demandez méthodes
Vue d'ensemble portée, qui sont des actions spécifiques que les applications peuvent être autorisées à effectuer au nom d'un utilisateur, indiquent la variété d'actions disponibles pour les intégrations personnalisées, notamment :
- /authentifier → collecte authentifiée ORCID iDs et lire les informations publiques
- / read-public → lire des informations publiques sur un seul ORCID iD ou effectuer des recherches
- /Lire-limité → lire les éléments publics et à visibilité limitée sur un enregistrement
- /activités/mise à jour → rédiger, mettre à jour et supprimer des éléments dans les sections affiliations, financements, travaux, revues par les pairs et ressources de recherche
- /personne/mise à jour → écrire, mettre à jour et supprimer des éléments dans les sections pour d'autres noms, pays, mots-clés, sites Web et liens sociaux et autres identifiants
- / webhook → permet aux applications d'être informées lorsque les données d'un ORCID l'enregistrement est modifié
- ouvert → OpenID Connect est une couche d'identité au-dessus du protocole OAuth 2.0
Une fois qu'un chercheur a accordé les autorisations nécessaires, l'application peut effectuer des actions sur son ORCID enregistrer à l'aide de l'API. Avec les méthodes de requête HTTPS, les applications clientes peuvent effectuer des actions telles que lire des données (appel GET), ajouter de nouvelles données (appel POST), mettre à jour des données existantes (appel PUT) et supprimer des données (appel DELETE).
Nous avons de vastes API Documentation et une fois que vous avez décidé du flux de travail le plus approprié pour votre système, vous pouvez commencer les tests dans le bac à sable. Le serveur de test sandbox est une copie du ORCID Logiciel de registre, où vous pourrez essayer des choses sans affecter aucun réel ORCID identifiants.
Vous pouvez demander informations d'identification du bac à sable avant même d'adhérer ORCID en tant qu'organisation membre, si vous souhaitez commencer les tests. Cependant, le soutien direct n'est disponible que pour les organisations membres.
ORCID héberge également une documentation qui vous aidera pour tout dépannage, y compris le guide d'erreur API commun. Si votre organisation est déjà une ORCID membre, vous bénéficierez du soutien de votre organisation chef de file du consortium (si vous êtes membre du consortium) ou directement de ORCID. Une fois votre développement en bac à sable terminé, notre organisation chef de file du consortium ou le ORCID vérifiera qu'il répond aux exigences minimales pour pouvoir générer des informations d'identification de production. Notez également que si vous utilisiez l'API publique et que votre organisation devient un ORCID organisation membre, nous pouvons transférer vos identifiants vers l'API membre.
Si la les exigences minimales pour une intégration sont remplies, votre intégration personnalisée peut alors être lancée facilement. Tout au long de ce processus, il est important de s'engager avec votre communauté pour les préparer au lancement et pour maximiser l'adoption organisationnelle.
Rien que l'année dernière, ORCID a aidé plus de 60 organisations à réussir une intégration personnalisée, et nous sommes là pour vous aider à identifier et à planifier celle qui convient à votre situation. Avec autant d'options d'intégration avec le ORCID Registre et voies de soutien disponibles, vous serez en mesure de choisir une solution qui vous aidera à atteindre les objectifs de votre organisation.
Avant de commencer votre intégration personnalisée, lisez notre documentation sur workflows suggérés, et pour plus d'informations sur la façon de planifier et d'exécuter une intégration personnalisée réussie, contactez notre équipe d'engagement (ou votre responsable de consortium si vous êtes membre du consortium).
Si vous souhaitez intégrer le ORCID registre, mais votre organisation n'est pas encore membre, contactez [email protected].
