Webhooks podem ser registrados por membros premium contra qualquer ORCID registro no registro. Os passos são:
Codifique o URL
Codifique em URL o URL que você deseja ORCID para chamar quando o registro do usuário é atualizado. Por exemplo, o seguinte URL:
https://nowhere2.com/0000-0002-7465-2162/updated
torna-se
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Construa o URL
Crie o URL completo para o ORCID Chamada de API começando com o URL do ORCID registro, em seguida, adicionando ‚√∫/webhook‚√π e a URL que você quer chamar. Então deve ficar assim: https://api.sandbox.orcid.org/{ORCID} / webhook / {URL-ENCODED-WEBHOOK-URL}
Por exemplo, usando o URL do webhook acima e o ORCID iD 0000-0002-7465-2162, o URL completo é:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Registre o webhook
Use seu token de acesso de webhooks para registrar seu webhook no usuário ORCID registro. Você precisa usar uma solicitação HTTP PUT, mas não deve incluir nada no corpo da solicitação.
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
A resposta deve ser 201, mas se o retorno de chamada já existir, a resposta será 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