故障排除

常見 API 錯誤代碼列表、它們可能的含義以及如何解決它們的提示可在我們的 技術文檔.

如果您無法解決您遇到的問題，請告訴我們。

在您可以將項目添加到 ORCID 記錄您需要將數據格式化為 ORCID 架構。 格式化您的數據 ORCID XML 或 JSON 中的消息模式。

我們的 GitHub 存儲庫包含在創建新項目時有助於格式化的資源 ORCID 記錄，並在閱讀現有項目時 ORCID 記錄：

• 示例 XML 文件
• 所有部分的 XSD ORCID 記錄

請注意，不同版本的 API 具有不同的消息格式。 版本 2.0 和 2.1 模式和示例也可用.

通過閱讀填充良好的記錄的元數據，可以輕鬆找到更多示例。

當請求與某個人交互的權限時 ORCID 用戶的記錄中，您可以指定一個或多個“範圍”。 每個範圍都允許您執行某些操作，例如讀取記錄或更新特定部分。

三足（授權碼）範圍

3條腿 指獲取用戶許可所涉及的三個參與者； ORCID，您的系統和用戶自己。

/認證

此範圍用於收集 ORCID iD 並僅閱讀記錄中的公共信息。 所有其他 3-legged 範圍都包括身份驗證權限，因此如果要求任何其他訪問權限，則可以省略此範圍。 此範圍在成員或公共 API 上可用。

/read-limited（僅限會員 API）

此範圍用於訪問讀取公共和有限可見性項目上的 ORCID 記錄。 此範圍僅在成員 API 上可用。

/activities/update（僅限會員 API）

此範圍用於編寫、更新和刪除某個機構的隸屬關係、資助、作品、專業活動、研究資源和同儕審查部分中的項目。 ORCID 記錄。 此範圍僅在成員 API 上可用。

/person/update（僅限會員 API）

此範圍用於寫入、更新和刪除記錄的其他名稱、關鍵字、國家/地區、研究人員 URL、網站和個人外部標識符部分中的項目。 此範圍僅在成員 API 上可用。

Openid

當需要 id_token 時，OpenID 集成商使用此範圍。 當包含 openid 範圍時，註冊表將在令牌響應中返回一個 id_token 並授予客戶端訪問該用戶的用戶信息端點的權限。 此範圍在公共和成員 API 上可用。

請注意，“openid”作用域不像其他作用域那樣以“/”開頭 ORCID API 範圍。 這是因為“openid”範圍不是由 ORCID，而是由 OpenID Connect 規範定義。 請看我們的 OpenID 文檔 獲取更多訊息

多個範圍

通過在身份驗證 URL 中列出範圍並在每個範圍之間使用編碼空格，可以在單個交互中請求多個範圍，例如 scope=/read-limited%20/activities/update%20/person/update

完全訪問

如果您想要讀取和編輯記錄的完全訪問權限，請在您的身份驗證 URL 中包含三個範圍：/read-limited、/activities/update 和 /person/update。 在 URL 中，它們將顯示為 scope=/read-limited%20/activities/update%20/person/update

2 條腿（客戶端憑據）範圍

對於某些活動，您不必徵求用戶的許可。 直接從 請求兩個分支的 OAuth 範圍 ORCID API，不需要研究人員授予許可。 具有這些範圍的代幣有效期為 20 年並可重複使用

/讀公開

此範圍用於讀取有關單個的公共信息 ORCID iD，搜尋 ORCID 記錄或讀取摘要資訊（僅限會員 API）。此範圍可在會員或公共 API 上使用。

/ webhook

此範圍允許客戶端應用程序在 ORCID 記錄，以便在記錄更新時接收通知。 此範圍適用於高級 ORCID 內部使用。

有兩種不同的更新範圍 - 一種用於傳記詳細信息，另一種用於活動。