任何擁有公共或成員 API 憑證的人都可以收到 /讀公開 訪問令牌。 要獲得令牌,您可以調用 ORCID API 令牌端點。
此過程通常稱為客戶端憑據 OAuth 流程,或 2 步 OAuth。
獲取訪問令牌以讀取沙箱上的公共數據的示例調用 - 用您的憑據替換佔位符(確保刪除括號。
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
然後,您將返回一個類似於以下內容的訪問令牌。 返回的令牌是長期存在的(大約 20 年不會過期),並且可以多次使用來檢索公共數據 ORCID 紀錄。
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
注意: 具有 /authenticate 範圍的所有令牌現在也包含 /read-public 範圍。 如果僅使用 /authenticate 範圍,則可以使用存儲的訪問令牌讀取公共數據,而無需再次獲取訪問令牌。
使用會員 API 的整合商可以使用 /讀公開 閱讀範圍 ORCID 記錄總結。