Como faço para registrar um webhook?

Webhooks podem ser registrados por membros premium contra qualquer ORCID registrar no registro. As etapas 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 grave e adicione ‚√∫/webhook‚√π e a URL que você deseja chamar. Portanto, deve se parecer com 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