任何擁有公共或成員 API 憑證的人都可以收到 /讀公開 訪問令牌。
- 若要使用公共 API,請遵循 指示 取得您的憑證。請注意,在使用公共 API 時,您必須遵守 ORCID 使用條款及條件 和我們的 API 公共客戶端條款與條件.
- 要使用會員 API,您的組織必須是 ORCID 會員,您可以申請憑證 註冊客戶端應用程序:Production Member API
若要取得令牌,您可以調用 ORCID API 令牌端點。此過程通常稱為客戶端憑證 OAuth 流程或兩步驟 OAuth。
獲取訪問令牌以讀取沙箱上的公共數據的示例調用 - 用您的憑據替換佔位符(確保刪除括號。
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public or member API client ID]
client_secret=[Your public or member 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 記錄總結。