Webhooky mohou prémioví členové zaregistrovat proti všem ORCID záznam v registru. Postup je následující:
Zakódujte adresu URL
URL zakódujte požadovanou adresu URL ORCID zavolat, když je uživatelův záznam aktualizován. Například následující URL:
https://nowhere2.com/0000-0002-7465-2162/updated
se stává
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Vytvořte adresu URL
Vytvořte úplnou adresu URL pro ORCID Volání API počínaje adresou URL ORCID zaznamenejte a poté přidejte ‚√∫/webhook‚√π a adresu URL, kterou chcete zavolat. Mělo by to tedy vypadat takto https://api.sandbox.orcid.org/{ORCID} / webhook / {URL-ENCODED-WEBHOOK-URL}
Například pomocí výše uvedené adresy URL webhooku a ORCID iD 0000-0002-7465-2162, úplná adresa URL je:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Zaregistrujte webhook
Použijte svůj přístupový token webhooků k registraci svého webhooku vůči uživateli ORCID záznam. Musíte použít požadavek HTTP PUT, ale neměli byste do těla požadavku nic zahrnout.
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
Odpověď by měla být 201, ale pokud zpětné volání již existovalo, bude odpověď 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