Highlight
- Stiamo implementando nuovi controlli di gestione del traffico API per garantire che i costi di supporto ORCID siano equamente ripartiti tra la nostra comunità e che gli utenti più assidui dei nostri servizi si facciano carico della loro giusta quota di onere
- Nel febbraio 2025, ORCID inizierà a implementare quote di utilizzo giornaliere e cambierà il limite di velocità per le API pubbliche e anonime
- L'API dei membri non verrà modificata e ORCID i membri non saranno interessati
- Prevediamo che ciò avrà effetto su meno dell'1% dei nostri clienti API pubblici o anonimi
Come altre organizzazioni infrastrutturali PID, ORCID l'adozione continua a crescere in tutto il mondo e le richieste di accesso ai dati conservati nel ORCID registro stanno crescendo insieme a esso. Parte di ORCIDLa missione di come organizzazione infrastrutturale senza scopo di lucro guidata dalla comunità è quella di garantire che ORCID i dati sono resi disponibili liberamente e apertamente, e con il minor numero possibile di barriere di accesso, a chiunque voglia utilizzarli. Ciò avviene attraverso la pubblicazione annuale del nostro file di dati pubblici, nonché fornendo le nostre API pubbliche, sia le API pubbliche (registrate) che quelle anonime, che chiunque può utilizzare gratuitamente per interrogare e accedere a tutti i dati pubblici nel ORCID registry. Questi servizi sono molto utilizzati. Il file di dati pubblici viene in genere scaricato migliaia di volte all'anno e le nostre API pubbliche gestiscono in genere 100M–150M di richieste al mese.
Un'altra parte fondamentale della nostra missione è garantire la nostra sostenibilità. Il nostro obiettivo è fornire servizi di identificazione persistenti e vogliamo assicurarci di essere presenti a lungo termine per mantenere questa promessa. Siamo molto grati per il supporto dei nostri oltre 1,400 membri dell'organizzazione che ci consentono di sostenerci finanziariamente. Nello spirito di equità, vogliamo anche garantire che i costi di supporto ORCID siano equamente ripartiti tra la nostra comunità e che gli utenti più assidui dei nostri servizi si facciano carico della loro giusta quota di onere. Con un utilizzo in continua crescita, abbiamo esaminato attentamente i modelli di accesso alle nostre API negli ultimi mesi e abbiamo notato che c'è un piccolo numero di clienti che effettua un volume di chiamate molto elevato, rispetto alla stragrande maggioranza degli utenti più modesti. Per aiutarci a gestire questo utilizzo, introdurremo alcune modifiche al modo in cui gestiamo il traffico API nel 2025.
Dall'inizio, ORCID ha avuto generosi limiti di velocità API (che specificano il numero massimo di richieste al secondo che possono essere effettuate da ciascun client API) su tutte le nostre API: Member, Public e Anonymous. Questi servono principalmente a mantenere la salute dei nostri sistemi e a garantire che un utilizzo eccessivo da parte di un client non influisca sull'accesso per tutti gli altri. Ora prevediamo di implementare nuove quote di utilizzo all'inizio del 2025 (che specificano il numero massimo di richieste che possono essere effettuate in un giorno da ciascun client API) per le nostre API Anonymous e Public, come descritto più avanti. Ridurremo anche il limite di velocità su quelle stesse API. La stragrande maggioranza degli utenti API non sarà interessata da queste quote; prevediamo che interesseranno meno dell'uno percento degli attuali client API Anonymous e Public! Poiché non introdurremo una quota di utilizzo né modificheremo il limite di velocità per l'API Member, non prevediamo che nessuno dei nostri membri ne sarà interessato.
Come viene gestito il traffico API?
- Limiti di velocità: il numero di richieste che possono essere effettuate a un client API entro un periodo di tempo definito, ovvero 24 richieste al secondo
- Quote di utilizzo: Il numero massimo di richieste che possono essere effettuate durante un periodo di tempo definito, ad esempio un periodo di 24 ore
Bilanciare gli obiettivi di consentire l'accesso a ORCID dati con la nostra sostenibilità a lungo termine
Quando abbiamo iniziato il processo di valutazione della modifica dei limiti di utilizzo delle nostre API all'inizio dell'anno, il nostro obiettivo era quello di incoraggiare il piccolo numero di utenti ad alto volume, a volte commerciali, delle nostre API pubbliche a condividere i costi del loro supporto, mantenendo al contempo le barriere più basse possibili per l'utilizzo di integrazioni su piccola scala, spesso non commerciali, in linea con uno dei nostri 10 principi fondanti:
"ORCID gli identificatori e i dati dei record (soggetti alle impostazioni sulla privacy) saranno resi disponibili tramite una combinazione di API e servizi gratuiti e a pagamento. Eventuali commissioni saranno fissate per garantire la sostenibilità di ORCID come organizzazione di beneficenza senza scopo di lucro focalizzata sulla persistenza a lungo termine del ORCID sistema."
All'inizio del 2024, abbiamo eseguito un'analisi dettagliata del traffico API anonimo e pubblico per modellare accuratamente l'impatto di vari scenari in modo da poter determinare quale soddisfacesse meglio questi doppi obiettivi. Abbiamo raccolto dati di utilizzo di diversi mesi per tutti i client che hanno effettuato oltre 1,000 chiamate API al giorno, raggruppando l'utilizzo da intervalli di indirizzi IP simili dell'API anonima, poiché alcune parti sembrano accedere all'API simultaneamente da più server per aggirare il nostro attuale limite di velocità.

La nostra analisi ha rivelato che una manciata di client API anonimi sta generando la stragrande maggioranza delle chiamate API, ovvero l'80% del traffico totale del registro, con alcuni client API anonimi che da soli effettuano circa 1 milione di chiamate al giorno. Questi sono i client che saranno principalmente interessati dalle nuove quote di utilizzo. Abbiamo discusso la nostra analisi con ORCID Board, esaminando vari scenari, prendendo in considerazione le implicazioni strategiche, di rischio e di equità di ciascuno. Le quote di utilizzo descritte di seguito sono state approvate dal Board nella riunione di settembre 2024.
La gestione del traffico API aiuta ORCIDLa comunità contribuisce equamente alla nostra sostenibilità
ORCIDL'attuale Rate Limit di è di 24 richieste al secondo per le API Member, Public e Anonymous. Attualmente non ci sono quote di utilizzo per nessuna delle nostre API.
A febbraio 2025 inizieremo a implementare quote di utilizzo giornaliere e modificheremo il limite di velocità per le API pubbliche e anonime come segue:
Nuovi limiti API | API anonima | API pubblica (registrata) | API membro — Invariato |
Limite di tariffa | 12 rich/sec | 12 rich/sec | 24 rich/sec |
Quota di utilizzo | 25k letture/giorno (Per indirizzo IP) | 100k letture/giorno (per ID cliente) | Nessuna quota di utilizzo |
La quota di utilizzo per l'API anonima verrà implementata gradualmente nell'arco di diversi mesi, per dare ai clienti il tempo di adattarsi.
Prevediamo che ciò avrà effetto su meno di 50 dei nostri client API anonimi e pubblici (su 5,700 integrazioni attive!). Non introdurremo una quota di utilizzo per la nostra API membro e il limite di velocità rimane invariato. Ciò significa che un ORCID Le organizzazioni associate che sfruttano appieno il nostro attuale limite di velocità potranno comunque effettuare circa 2 milioni di richieste al giorno, ovvero ben al di sopra dei modelli di utilizzo rilevati dalla nostra analisi; pertanto non prevediamo che nessuno dei nostri associati subirà interruzioni di alcun tipo.
ORCID fornirà sempre il nostro annuale File di dati pubblici gratuito per chiunque desideri scaricarlo, tuttavia è fondamentale garantire un accesso equo e giusto ai dati presenti nel ORCID registro ora e in futuro. Rivedere il nostro approccio alla gestione del traffico API è una parte di questo. A ottobre, abbiamo aggiornato il nostro "Termini di servizio delle API pubbliche" (in precedenza noti come "Termini di servizio del cliente pubblico") che specificano ulteriormente i termini di utilizzo per le nostre API pubbliche e anonime. In esso:
- Chiarito che i termini si applicano sia alle nostre API anonime (non registrate) che pubbliche (registrate)
- Chiarita la definizione di "uso commerciale"
- Ha spiegato che oltre alla limitazione, potremmo utilizzare limiti di velocità o applicare quote di utilizzo per gestire il traffico verso le API pubbliche
- È stato spiegato che è necessario rispettare i limiti di tariffa e le quote di utilizzo pubblicati quando si accede alle API pubbliche
- Sono state spiegate le circostanze in cui accetteremo di trasferire le tue credenziali API pubbliche alla tua organizzazione tramite la Member API
- Sono state chiarite le circostanze in cui è possibile utilizzare i dati ottenuti dalle API pubbliche per comunicazioni di marketing, al fine di rispettare le normative sulla privacy
- Aggiunta una nota riguardante lo stato delle traduzioni dei Termini di servizio
Incoraggiamo gli utenti non commerciali della nostra API anonima il cui utilizzo è superiore a 25 letture/giorno ma inferiore a 100 letture/giorno a registrarsi per una chiave API pubblica gratuita tramite il loro My ORCID pagina. Ciò ci consentirà di comprendere meglio chi sta utilizzando in grandi volumi le nostre API e di contattarlo se il suo utilizzo raggiunge un livello tale da avere un impatto su altri utenti di API pubbliche. Per quelle organizzazioni che utilizzano le nostre API a fini non commerciali oltre 100 letture al giorno e per tutti gli accessi commerciali alle API, ti invitiamo a prendere in considerazione l'adesione ORCID come membro organizzativo, che offre una serie di altri vantaggi, tra cui la sincronizzazione in tempo reale con il ORCID file di dati pubblici, nonché accesso API senza quote di utilizzo e un generoso limite di velocità.
Implementando modeste quote di utilizzo e adeguando il limite di velocità per i client API anonimi e pubblici, siamo certi che saremo in grado di mantenere l'integrità e la disponibilità dei nostri servizi, anche con la crescita della domanda, in un modo che garantirà la nostra sostenibilità a lungo termine e faciliterà la nostra capacità di garantire un accesso equo ai nostri dati. Se hai commenti o domande sui prossimi cambiamenti per gli utenti delle API pubbliche o anonime, o aggiornamenti ai Termini di servizio delle API pubbliche, sentiti libero di postare nel nostro Forum del gruppo utenti API.