Les webhooks peuvent être enregistrés par les membres premium contre n'importe quel ORCID enregistrement dans le registre. Les étapes sont les suivantes :
Encoder l'URL
URL-encoder l'URL que vous voulez ORCID à appeler lorsque le dossier de l'utilisateur est mis à jour. Par exemple l'URL suivante :
https://nowhere2.com/0000-0002-7465-2162/updated
devient
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Construire l'URL
Créez l'URL complète pour le ORCID Appel d'API commençant par l'URL du ORCID enregistrez puis ajoutez ‚√∫/webhook‚√π et l'URL que vous voulez appeler. Il devrait donc ressembler à https://api.sandbox.orcid.org/{ORCID}/webhook/{URL-ENCODÉ-WEBHOOK-URL}
Par exemple, en utilisant l'URL du webhook ci-dessus et le ORCID iD 0000-0002-7465-2162, l'URL complète est :
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Enregistrer le webhook
Utilisez vos webhooks‚ jeton d'accès pour enregistrer votre webhook auprès de l'utilisateur ORCID enregistrer. Vous devez utiliser une requête HTTP PUT, mais vous ne devez rien inclure dans le corps de la requête.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdatedn HEADER: Accept: application/json HEADER: Authorization: Bearer [Your access token]n HEADER: Content-Length: 0n METHOD: PUT
La réponse doit être un 201, mais si le rappel existait déjà, alors la réponse sera 204.
HTTP/1.1 201nServer: nginx/1.1.19nConnection: keep-alive Location: https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Frequestb.in%2Fz57lzcz5