Webhooki mogą być rejestrowane przez członków premium przeciwko dowolnym ORCID wpis w rejestrze. Kroki są następujące:
Zakoduj adres URL
Adres URL — zakoduj żądany adres URL ORCID zadzwonić, gdy rekord użytkownika zostanie zaktualizowany. Na przykład następujący adres URL:
https://nowhere2.com/0000-0002-7465-2162/updated
staje się
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Zbuduj adres URL
Zbuduj pełny adres URL dla ORCID Wywołanie interfejsu API rozpoczynające się od adresu URL pliku ORCID nagraj, a następnie dodaj ‚√∫/webhook‚√π i adres URL, który chcesz wywołać. Powinien więc wyglądać jak https://api.sandbox.orcid.org/{ORCID}/webhook/{URL-ZAKODOWANY-WEBHOOK-URL}
Na przykład przy użyciu powyższego adresu URL elementu webhook i pliku ORCID iD 0000-0002-7465-2162, pełny adres URL to:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Zarejestruj webhooka
Użyj swojego tokena dostępu do webhooków, aby zarejestrować swój webhook względem użytkownika ORCID nagrywać. Musisz użyć żądania HTTP PUT, ale nie powinieneś niczego umieszczać w treści żądania.
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
Odpowiedzią powinno być 201, ale jeśli wywołanie zwrotne już istniało, odpowiedź wyniesie 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