Les systèmes des fournisseurs peuvent offrir aux clients des ORCID intégrations, leur offrant tous les avantages de leur ORCID l'adhésion sans avoir à construire leur propre intégration. Ce flux de travail décrit les directives générales pour la création d'un ORCID l'intégration en tant que fournisseur proposant des logiciels aux clients. Lors de la construction de votre ORCID intégration, vous devrez vous assurer que votre intégration permet à vos clients de répondre aux exigences pour la délivrance des informations d'identification de l'API membre , ainsi que de suivre nos meilleures pratiques d'intégration.
- Authentifier ORCID Les identifiants utilisant le processus OAuth pour les individus afin de s'assurer qu'ils sont correctement associés à leurs affiliations et contributions.
- Ecran les identifiants authentifiés publiquement dans votre système conformément à nos directives d'affichage, pour signaler aux chercheurs que votre système est raccordé pour prendre en charge leur utilisation de ORCID.
- Contacts les données des utilisateurs de votre système à leurs ORCID enregistrements, permettant à vos clients de mettre à jour leurs enregistrements de chercheurs si nécessaire.
- Collecte les données des utilisateurs de leur ORCID enregistrement pour aider à remplir les données dans votre système ou vos formulaires.
- Synchroniser les données de votre système avec le ORCID Registre via un flux d'informations bidirectionnel.
Nous vous recommandons de contacter votre responsable d'engagement pour discuter de vos plans d'intégration avant de commencer votre développement.
INSTALLATION DU SYSTÈME
Tous les systèmes qui se connectent avec ORCID besoin de stocker le ORCID ID et jetons d'accès collectés, et vous pouvez également stocker des informations lues à partir du ORCID record.
- Stockez les identifiants authentifiés : Votre système doit pouvoir accepter et stocker ORCID ID avec les informations de l'utilisateur.
- Code d'autorisation d'échange : Votre système doit être capable de capturer un code d'autorisation à six chiffres et de l'échanger immédiatement contre un jeton d'accès.
- Stockez la réponse du jeton : Votre système doit également être capable d'accepter et de stocker ORCID iD et le jeton d'accès. Nous vous recommandons de stocker la réponse complète du jeton avec les informations de l'utilisateur, notamment :
- Jetons d'accès persistants
- Actualiser les jetons
- Portées demandées
- Expiration de la portée
- Éléments à stocker lors de l'écriture des données : Si votre système écrit des données dans ORCID enregistrements :
- Votre système doit pouvoir enregistrer un mettre le code pour chaque élément ajouté à un ORCID enregistrer (et grouper ID pour examen par les pairs). Les codes de vente sont des identifiants uniques pour les articles dans le ORCID Registre.
- Votre système doit pouvoir envoyer des données au format XML ou JSON au format ORCID schéma de message.
- Consigner les interactions: Votre système doit enregistrer les deux appels passés au ORCID API et réponses reçues ; cela est nécessaire pour que notre équipe puisse vous aider si un problème survient plus tard. Idéalement, votre client devrait également être en mesure de lire et de partager ces journaux.
- Sélection d'API: votre système doit permettre aux clients de choisir s'ils utilisent des informations d'identification d'API publiques ou membres (si votre système autorise les deux).
- Exportation de données: Votre système doit offrir un moyen à vos clients d'exporter les ORCID ID et données d'échange de jetons (tokens d'accès, jetons d'actualisation, étendues, expiration de l'étendue). Si votre système écrit également des données, il doit également inclure les codes put pertinents avec les exportations de données.
ORCID Identifiants API
ORCID exige que l'organisation qui demande les données, c'est-à-dire votre client, utilise ses propres ORCID Identifiants de l'API. Cela indique clairement qui demande l'accès pour mettre à jour ORCID dossiers et est requis par ORCIDl'accord d'adhésion de. L'organisme doit obtenir le ORCID Identifiants API seuls. Si vous aidez l'organisation à gérer le système et que ses informations d'identification API nécessitent des modifications telles que la mise à jour des URI de redirection, l'organisation doit soumettre la demande de modification.
FAITES-NOUS CONNAÎTRE VOTRE SYSTÈME
Une fois que vous êtes prêt à libérer votre système, nous contacter pour lancer le processus. Nous aurons besoin de savoir :
- Le nom de votre système et le nom du développeur.
- Une brève description de ses fonctionnalités et de la façon dont il se connecte au ORCID Registre.
- Votre disponibilité pour un examen d'intégration, afin que nous puissions déterminer si ORCID les membres doivent subir un examen d'intégration complet avant de recevoir les informations d'identification de l'API, ainsi que confirmer comment votre système aide les membres à rencontrer Collect & Connect.
- Liens vers des pages, des présentations et/ou des systèmes de démonstration auxquels nous pouvons référer les organisations afin qu'elles puissent en savoir plus sur votre système.
- Contacts techniques et administratifs que nous pouvons inviter à rejoindre la liste des utilisateurs de l'API ainsi qu'à assurer la liaison directement, afin que vous puissiez fournir à vos clients les dernières fonctionnalités.