- 我們正在實施新的 API 流量管理控制措施,以協助確保支援成本 ORCID 在我們的社區中公平分擔,我們服務的最大用戶承擔其公平份額的負擔
- 今年二月2025, ORCID 將開始實施每日使用配額並更改公共和匿名 API 的速率限制
- 會員API不會改變,並且 ORCID 會員不會受到影響
- 我們預計這將影響不到 1% 的公共或匿名 API 客戶
與其他 PID 基礎設施組織一樣, ORCID 全球範圍內的採用率持續成長,並且要求存取儲存在 ORCID 註冊表也隨之增長。一部分 ORCID作為社區驅動的非營利基礎設施組織,其使命是確保 ORCID 數據免費、公開地提供給任何可能想要使用它的人,而且訪問障礙盡可能少。我們透過每年發佈公共資料檔案以及提供公共 API(包括公共(註冊)和匿名 API)來實現這一目標,任何人都可以免費使用這些 API 來查詢和存取資料庫中的所有公共資料。 ORCID 註冊表。這些服務都得到了很好的運用。公共資料檔案通常每年下載數千次,我們的公共 API 通常每月處理 100M-150M 請求。
我們使命的另一個關鍵部分是確保我們的永續性。我們的目標是提供持久的識別符服務,並且我們希望確保長期履行這項承諾。我們非常感謝 1,400 多名組織成員的支持,他們使我們能夠在經濟上維持生計。本著公平的精神,我們也希望確保支援成本 ORCID 我們的社區之間公平地分享這些費用,而我們服務的最大用戶承擔了他們公平的負擔。隨著使用量的不斷增長,近幾個月來我們一直在仔細研究 API 的存取模式,並注意到與其他客戶端相比,有少數客戶端正在進行大量呼叫。為了幫助我們管理這種使用情況,我們將在 2025 年對管理 API 流量的方式進行一些更改。
從一開始, ORCID 我們的所有 API(會員、公開和匿名)都有慷慨的 API 速率限制(指定每個 API 用戶端每秒可以發出的最大請求數)。這些主要用於維護我們系統的健康,並確保一個客戶端的過度使用不會影響其他人的存取。我們現在計劃在 2025 年初為我們的匿名和公共 API 實施新的使用配額(指定每個 API 用戶端每天可以發出的最大請求數),如下文進一步所述。我們還將降低這些相同 API 的速率限制。絕大多數 API 使用者將不會受到這些配額的影響;我們預計它們將影響不到百分之一的當前匿名和公共 API 用戶端!由於我們不會引入使用配額或更改會員 API 的速率限制,因此我們預計我們的任何會員都不會受到影響。
如何管理 API 流量?
- 速率限制: 在定義的時間段內可以向 API 用戶端發出的請求數,即每秒 24 個請求
- 使用配額: 在定義的時間段內(例如 24 小時)可以發出的最大請求數
平衡實現訪問的目標 ORCID 數據與我們的長期可持續性
當我們在今年稍早開始考慮更改 API 的使用限制時,我們的目標是鼓勵我們公共 API 的少數大容量用戶(有時是商業用戶)分擔支援它們的成本,同時保持盡可能低的使用障礙,以進行較小規模的、通常是非商業的集成,並與我們的政策保持一致 10 大創始原則:
“ORCID 標識符和記錄數據(取決於隱私設置)將通過免費和收費 API 和服務的組合提供。 將設置任何費用以確保可持續發展 ORCID 作為一個專注於長期堅持的非營利性慈善組織 ORCID 系統。”
2024 年初,我們對匿名和公共 API 流量進行了詳細分析,以準確模擬各種場景的影響,從而確定哪一種最能滿足這些雙重目標。我們收集了每天進行超過1,000 次API 呼叫的所有客戶端的幾個月使用數據,對匿名API 的類似IP 位址範圍的使用情況進行了聚類,因為某些方似乎從多個伺服器同時訪問API,以規避我們的要求。

我們的分析顯示,少數匿名 API 用戶端產生了絕大多數 API 呼叫(佔總註冊流量的 80%),其中一些匿名 API 用戶端每天單獨進行約 1 萬次呼叫。這些客戶將主要受到新使用配額的影響。我們與以下人士討論了我們的分析 ORCID 董事會審查各種情景,考慮每種情景的策略、風險和公平影響。以下概述的使用配額已由董事會在 2024 年 XNUMX 月的會議上批准。
API 流量管理有幫助 ORCID的社區為我們的永續發展做出公平的貢獻
ORCID會員、公用和匿名 API 的當前速率限制為每秒 24 個請求。目前我們的任何 API 都沒有使用配額。
2025 年 XNUMX 月,我們將開始實作每日使用配額,並對公用和匿名 API 的速率限制進行以下更改:
新的 API 限制 | 匿名API | 公共(註冊)API | 會員API — 不變 |
速率限制 | 12 請求/秒 | 12 請求/秒 | 24 請求/秒 |
使用配額 | 25 次閱讀/天 (每個 IP 位址) | 100 次閱讀/天 (每個客戶 ID) | 無使用配額 |
匿名 API 的使用配額將在幾個月內逐步推出,以便讓客戶有時間適應。
我們預計這將影響不到 50 個匿名和公共 API 用戶端(共 5,700 個活躍整合!)。我們不會為會員 API 引入使用配額,且速率限制保持不變。這意味著一個 ORCID 充分利用我們當前速率限制的成員組織仍然能夠每天發出近 2 萬個請求,這遠高於我們分析揭示的使用模式,因此我們預計我們的任何成員都不會遇到任何類型的中斷。
ORCID 將始終提供我們的年度 公共數據文件 任何想要下載它的人都可以免費使用,但至關重要的是,我們要確保公平公正地存取該數據中的數據 ORCID 現在和將來都可以註冊。回顧我們的 API 流量管理方法是其中的一部分。十月,我們更新了“公共 API 服務條款」(以前稱為「公共客戶服務條款」),進一步規定了我們的公共和匿名 API 的使用條款。在其中我們:
- 澄清這些條款適用於我們的匿名(非註冊)和公共(註冊)API
- 澄清了「商業用途」的定義
- 解釋了除了限制之外,我們還可以使用速率限製或應用使用配額來管理公共 API 的流量
- 解釋了您在存取公共 API 時必須遵守我們發布的速率限制和使用配額
- 解釋了在什麼情況下我們會同意透過會員 API 將您的公共 API 憑證轉移到您的組織
- 澄清了在什麼情況下您可以使用從公共 API 獲得的資料進行行銷傳播,以遵守隱私法規
- 新增了有關服務條款翻譯狀態的註釋
我們鼓勵使用量超過 25k 次/天但低於 100k 次/天的匿名 API 的非商業用戶透過他們的 My 註冊免費的公共 API 金鑰。 ORCID 頁。這將使我們能夠更好地了解誰在大量使用我們的 API,並在其使用達到可能影響其他公共 API 用戶的水平時與他們聯繫。對於那些每天對我們的 API 進行非商業用途的讀取次數超過 100 萬次的組織以及所有商業 API 訪問,我們鼓勵您考慮加入 ORCID 作為一個 組織成員,它提供了許多其他好處,包括與 ORCID 公共資料文件,以及沒有使用配額和慷慨的速率限制的 API 存取。
透過實施適度的使用配額並調整匿名和公共 API 用戶端的速率限制,我們相信我們將能夠保持服務的完整性和可用性(即使需求增長),從而確保我們的長期發展可持續性並提高我們公平訪問我們數據的能力。如果您對公共或匿名 API 使用者即將發生的變更或公共 API 服務條款的更新有任何意見或疑問,請隨時在我們的 API 使用者群組論壇.