Toute personne disposant d'informations d'identification API publiques ou membres peut recevoir un / read-public jeton d'accès.
- Pour utiliser l'API publique, suivez les instructions des instructions pour obtenir vos identifiants. Veuillez noter que, lors de l'utilisation de l'API publique, vous devez respecter les ORCID Conditions générales d'utilisation et à notre expertise, Conditions générales du client public de l'API.
- Pour utiliser l'API membre, votre organisation doit être une ORCID membre, et vous pouvez demander des informations d'identification à Enregistrer une application cliente : API de membre de production
Pour obtenir un jeton, vous passez un appel au ORCID Point de terminaison du jeton API. Ce processus est souvent appelé flux OAuth d'informations d'identification client, ou OAuth en deux étapes.
Un exemple d'appel pour obtenir un jeton d'accès pour lire les données publiques sur le bac à sable - remplacez les espaces réservés par vos informations d'identification (veillez à supprimer les crochets.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public or member API client ID]
client_secret=[Your public or member API secret]
grant_type=client_credentials
scope=/read-public
Vous recevrez alors un jeton d'accès similaire au suivant. Le jeton renvoyé a une longue durée de vie (n'expirant pas pendant environ 20 ans) et peut être utilisé plusieurs fois pour récupérer des données publiques à partir de ORCID Records.
"access_token":"43914fb8-7f34-417d-9d4e-eaa820c92c0d",
"token_type":"bearer",
"expires_in":631138518,
"scope":"/read-public",
"orcid":null
À noter: Tous les jetons avec l'étendue / authenticate ont maintenant également l'étendue / read-public incluse. Si vous utilisez uniquement l'étendue / authenticate, vous pouvez utiliser les jetons d'accès stockés pour lire les données publiques sans avoir à obtenir à nouveau un jeton d'accès.
Les intégrateurs utilisant l'API membre peuvent utiliser le / read-public portée à lire ORCID enregistrer des résumés.