Highlights
- Implementujeme nové ovládací prvky API Traffic Management, abychom zajistili snížení nákladů na podporu ORCID jsou spravedlivě sdíleny naší komunitou a že nejtěžší uživatelé našich služeb nesou svůj spravedlivý díl břemene
- V únoru 2025, ORCID začne zavádět denní kvóty využití a změní limit sazby pro veřejné a anonymní API
- Členové API se nezmění a ORCID členů nebude ovlivněno
- Předpokládáme, že to ovlivní méně než 1 % našich veřejných nebo anonymních klientů API
Stejně jako ostatní organizace infrastruktury PID, ORCID přijetí celosvětově stále roste a požadavky na přístup k údajům uchovávaným v ORCID Registr roste spolu s ním. Část ORCIDPosláním společnosti jako komunitně řízené neziskové infrastrukturní organizace je to zajistit ORCID data jsou zpřístupněna volně a otevřeně a s co nejmenšími překážkami v přístupu každému, kdo by je mohl chtít používat. Dosahujeme toho prostřednictvím každoročního vydávání našeho souboru veřejných dat a také poskytováním našich veřejných rozhraní API – veřejných (registrovaných) i anonymních rozhraní API – které může kdokoli bezplatně používat k dotazování a přístupu ke všem veřejným údajům v ORCID registru. Tyto služby jsou velmi dobře využívány. Veřejný datový soubor se obvykle stahuje mnoho tisíckrát ročně a naše veřejná rozhraní API obvykle zpracovávají 100 až 150 milionů požadavků za měsíc.
Další klíčovou součástí našeho poslání je zajistit naši udržitelnost. Naším cílem je poskytovat služby trvalých identifikátorů a chceme zajistit, že budeme nablízku dlouhodobě, abychom tento slib splnili. Jsme velmi vděční za podporu našich 1,400 XNUMX+ organizačních členů, kteří nám umožňují finančně se udržet. V duchu spravedlnosti chceme také zajistit, aby náklady na podporu ORCID jsou spravedlivě sdíleny naší komunitou a že nejtěžší uživatelé našich služeb nesou svůj spravedlivý díl břemene. Vzhledem k neustále rostoucímu využití jsme v posledních měsících podrobně sledovali vzorce přístupu k našim rozhraním API a všimli jsme si, že existuje malý počet klientů, kteří uskutečňují velmi velký objem hovorů ve srovnání s drtivá většina skromnějších uživatelů. Abychom nám pomohli toto využití spravovat, zavedeme v roce 2025 některé změny ve způsobu, jakým spravujeme provoz rozhraní API.
od začátku, ORCID má velkorysé limity rychlosti API (určující maximální počet požadavků za sekundu, které může provést každý klient API) ve všech našich rozhraních API – členské, veřejné a anonymní. Ty slouží především k udržení zdraví našich systémů a k zajištění toho, aby nadměrné používání jedním klientem neovlivnilo přístup pro všechny ostatní. Nyní plánujeme implementovat nové kvóty využití na začátku roku 2025 (s uvedením maximálního počtu požadavků, které může každý klient API provést za den) pro naše anonymní a veřejná rozhraní API, jak je uvedeno níže. Rovněž snížíme limit rychlosti pro stejná rozhraní API. Naprostá většina uživatelů API nebude těmito kvótami ovlivněna; předpokládáme, že ovlivní méně než jedno procento současných klientů Anonymous a Public API! Vzhledem k tomu, že nebudeme zavádět kvótu využití ani měnit limit sazby pro členské API, nepředpokládáme, že to bude mít dopad na některého z našich členů.
Jak je spravován provoz API?
- Limity sazeb: počet požadavků, které mohou být uskutečněny na API klienta během definovaného časového období, tj. 24 požadavků za sekundu
- Kvóty použití: Maximální počet požadavků, které lze provést během definovaného časového období, např. 24 hodin
Vyvážení cílů umožnění přístupu k ORCID data s naší dlouhodobou udržitelností
Když jsme začátkem roku zahájili proces zvažování změny limitů využití našich API, naším cílem bylo povzbudit malý počet velkoobjemových, někdy komerčních uživatelů našich veřejných API, aby se podíleli na nákladech na jejich podporu. při zachování co nejnižších překážek pro použití pro menší, často nekomerční integrace, v souladu s jedním z našich 10 základních principů:
"ORCID identifikátory a záznamová data (v závislosti na nastavení ochrany osobních údajů) budou zpřístupněna prostřednictvím kombinace bezplatných a za poplatek API a služeb. Veškeré poplatky budou stanoveny tak, aby byla zajištěna udržitelnost ORCID jako nezisková charitativní organizace zaměřená na dlouhodobou perzistenci ORCID Systém."
Dříve v roce 2024 jsme provedli podrobnou analýzu anonymního a veřejného provozu API, abychom přesně modelovali dopad různých scénářů, abychom mohli určit, který z nich nejlépe splnil tyto dvojí cíle. Shromáždili jsme údaje o používání za několik měsíců pro všechny klienty, kteří uskutečnili více než 1,000 XNUMX volání API za den, seskupili využití z podobných rozsahů IP adres anonymního API, protože se zdá, že některé strany přistupují k API současně z více serverů, aby obešly naše aktuální limit sazby.
Naše analýza odhalila, že hrstka klientů Anonymous API generuje drtivou většinu volání API – 80 % celkového provozu v registru – a někteří klienti Anonymous API sami provádějí přibližně 1 milion volání denně. Toto jsou klienti, kterých se nové kvóty využití dotknou především. Probrali jsme naši analýzu s ORCID Představenstvo, přezkoumává různé scénáře a bere v úvahu strategické, rizikové a kapitálové důsledky každého z nich. Níže uvedené kvóty využití byly schváleny představenstvem na svém zasedání v září 2024.
Pomáhá API Traffic Management ORCID's komunita spravedlivě přispívá k naší udržitelnosti
ORCIDAktuální rychlostní limit je 24 požadavků za sekundu pro členské, veřejné a anonymní API. V současné době neexistují žádné kvóty využití pro žádné z našich rozhraní API.
V únoru 2025 začneme zavádět denní kvóty využití a změníme limit sazby pro veřejná a anonymní rozhraní API následovně:
| Nové limity API | Anonymní API | Veřejné (registrované) API | Členské API — Beze změny |
| Limit sazby | 12 požadavku/s | 12 požadavku/s | 24 požadavku/s |
| Kvóta použití | 25 tisíc přečtení/den (Za IP adresu) | 100 tisíc přečtení/den (za ID klienta) | Žádná kvóta využití |
Kvóta použití pro anonymní API bude zaváděna v postupných krocích během několika měsíců, aby měli klienti čas se přizpůsobit.
Očekáváme, že se to dotkne méně než 50 našich klientů Anonymous a Public API (z 5,700 XNUMX aktivních integrací!). Nebudeme zavádět kvótu využití pro naše členské rozhraní API a limit sazby zůstává nezměněn. To znamená, že an ORCID Členská organizace, která plně využívá našeho současného sazebního limitu, bude i nadále schopna podávat téměř 2 miliony žádostí denně, což je výrazně nad vzorci používání, které odhalila naše analýza, takže neočekáváme, že by některý z našich členů zasáhl jakékoli narušení. .
ORCID bude vždy poskytovat naše roční Veřejný datový soubor zdarma pro každého, kdo si jej přeje stáhnout, je však zásadní, abychom zajistili spravedlivý a spravedlivý přístup k údajům nalezeným v ORCID registru nyní i do budoucna. Jednou z částí je přezkoumání našeho přístupu k řízení provozu API. V říjnu jsme aktualizovali naše „Podmínky služby veřejných rozhraní API“ (dříve známé jako „Podmínky služby veřejného klienta“), které dále specifikují podmínky použití pro naše veřejná i anonymní rozhraní API. V něm jsme:
- Objasněno, že podmínky platí pro naše anonymní (neregistrovaná) i veřejná (registrovaná) rozhraní API
- Vyjasnění definice „komerčního využití“
- Vysvětleno, že kromě omezování můžeme ke správě provozu veřejných rozhraní API použít limity rychlosti nebo použít kvóty využití
- Vysvětleno, že při přístupu k veřejným rozhraním API musíte dodržovat naše zveřejněné limity sazeb a kvóty využití
- Vysvětlení okolností, za kterých budeme souhlasit s přenosem vašich přihlašovacích údajů k veřejnému rozhraní API do vaší organizace prostřednictvím Member API
- Objasnění okolností, za kterých můžete používat data získaná z veřejných rozhraní API pro marketingovou komunikaci, abyste dodrželi předpisy o ochraně osobních údajů
- Přidána poznámka týkající se stavu překladů smluvních podmínek
Doporučujeme nekomerčním uživatelům našeho anonymního API, kteří využívají více než 25 100 přečtení/den, ale méně než XNUMX XNUMX přečtení/den, aby si zaregistrovali bezplatný veřejný klíč API prostřednictvím svého My ORCID strana. To nám umožní lépe porozumět tomu, kdo ve velkém množství využívá naše rozhraní API, a kontaktovat je, pokud jejich používání dosáhne úrovně, kdy by to mohlo ovlivnit ostatní uživatele veřejného rozhraní API. Těm organizacím, které nekomerčně využívají naše rozhraní API více než 100 XNUMX přečtení/den, a všem komerčním přístupům k rozhraním API vám doporučujeme zvážit připojení. ORCID as organizační člen, který nabízí řadu dalších výhod, včetně synchronizace v reálném čase s ORCID veřejný datový soubor, stejně jako přístup k API bez kvót využití a velkorysého limitu sazby.
Zavedením skromných kvót využití a úpravou limitu sazby pro anonymní a veřejné klienty API jsme si jisti, že budeme schopni zachovat integritu a dostupnost našich služeb – i když poptávka poroste – způsobem, který zajistí naši dlouhodobou udržitelnost a usnadňují naši schopnost poskytovat spravedlivý přístup k našim údajům. Máte-li jakékoli komentáře nebo dotazy týkající se nadcházejících změn pro uživatele veřejných nebo anonymních rozhraní API nebo aktualizací podmínek služby Public API, neváhejte je zveřejnit v našem Fórum skupiny uživatelů API.
