Основные моменты:
- Мы внедряем новые элементы управления трафиком API, чтобы гарантировать снижение затрат на поддержку ORCID справедливо распределены в нашем сообществе, и самые активные пользователи наших услуг несут свою справедливую долю бремени
- В феврале 2025, ORCID начнет внедрять ежедневные квоты использования и изменять ограничение скорости для публичных и анонимных API
- API-интерфейс участника не будет изменен, и ORCID Участники не будут затронуты
- Мы ожидаем, что это затронет менее 1% наших клиентов публичного или анонимного API.
Как и другие организации инфраструктуры PID, ORCID Распространение данных продолжает расти во всем мире, и запросы на доступ к данным, хранящимся в ORCID Реестр растет вместе с ним. Часть ORCIDМиссия как некоммерческой инфраструктурной организации, работающей на благо общества, заключается в том, чтобы гарантировать, что ORCID Данные предоставляются свободно и открыто, и с минимальным количеством барьеров для доступа, для любого, кто может захотеть их использовать. Мы достигаем этого посредством ежегодного выпуска нашего файла публичных данных, а также посредством предоставления наших публичных API — как публичных (зарегистрированных), так и анонимных API, — которые любой может использовать бесплатно для запроса и доступа ко всем публичным данным в ORCID реестр. Эти сервисы очень хорошо используются. Публичный файл данных обычно загружается много тысяч раз в год, и наши публичные API обычно обрабатывают 100–150 млн запросов в месяц.
Другая ключевая часть нашей миссии — обеспечение нашей устойчивости. Наша цель — предоставление услуг постоянного идентификатора, и мы хотим гарантировать, что мы будем существовать в долгосрочной перспективе, чтобы выполнить это обещание. Мы очень благодарны за поддержку наших 1,400+ членов организации, которые позволяют нам финансово поддерживать себя. В духе справедливости мы также хотим гарантировать, что расходы на поддержку ORCID справедливо распределены среди нашего сообщества, и что самые активные пользователи наших услуг несут свою справедливую долю бремени. С постоянно растущим использованием мы внимательно изучили закономерности доступа к нашим API в последние месяцы и заметили, что есть небольшое количество клиентов, которые делают очень большой объем вызовов по сравнению с подавляющим большинством более скромных пользователей. Чтобы помочь нам управлять этим использованием, мы внесем некоторые изменения в способ управления трафиком API в 2025 году.
С начала, ORCID имел щедрые ограничения скорости API (определяющие максимальное количество запросов в секунду, которые может сделать каждый клиент API) для всех наших API — Member, Public и Anonymous. Они служат в первую очередь для поддержания работоспособности наших систем и обеспечения того, чтобы чрезмерное использование одним клиентом не влияло на доступ для всех остальных. Теперь мы планируем внедрить новые квоты использования в начале 2025 года (определяющие максимальное количество запросов, которые может сделать в день каждый клиент API) для наших Anonymous и Public API, как описано ниже. Мы также снизим ограничение скорости для этих же API. Подавляющее большинство пользователей API не будут затронуты этими квотами; мы ожидаем, что они затронут менее одного процента текущих клиентов Anonymous и Public API! Поскольку мы не будем вводить квоту использования или изменять ограничение скорости для Member API, мы не ожидаем, что кто-либо из наших участников будет затронут.
Как управляется трафик API?
- Ограничения ставок: количество запросов, которые могут быть сделаны клиенту API в течение определенного периода времени, т. е. 24 запроса в секунду
- Квоты использования: Максимальное количество запросов, которые можно сделать в течение определенного периода времени, например, 24 часа.
Баланс целей предоставления доступа к ORCID данные с нашей долгосрочной устойчивостью
Когда в начале года мы начали рассматривать вопрос об изменении лимитов использования наших API, нашей целью было побудить небольшое количество крупных, иногда коммерческих, пользователей наших публичных API разделить расходы на их поддержку, сохраняя при этом минимально возможные барьеры для использования для менее масштабных, часто некоммерческих интеграций, в соответствии с одним из наших 10 основополагающих принципов:
ORCID идентификаторы и данные записи (с учетом настроек конфиденциальности) будут доступны через комбинацию бесплатных и платных API и сервисов. Любые сборы будут установлены для обеспечения устойчивости ORCID как некоммерческая благотворительная организация, ориентированная на долгосрочное сохранение ORCID Система «.
Ранее в 2024 году мы провели подробный анализ трафика анонимных и публичных API, чтобы точно смоделировать влияние различных сценариев, чтобы мы могли определить, какой из них лучше всего соответствует этим двойным целям. Мы собрали данные об использовании за несколько месяцев для всех клиентов, которые совершали более 1,000 вызовов API в день, кластеризовав использование из схожих диапазонов IP-адресов анонимного API, поскольку некоторые стороны, по-видимому, получают доступ к API одновременно с нескольких серверов, чтобы обойти наше текущее ограничение скорости.
Наш анализ показал, что несколько клиентов Anonymous API генерируют подавляющее большинство вызовов API — 80% от общего трафика реестра — при этом некоторые клиенты Anonymous API в одиночку делают около 1 млн вызовов в день. Это клиенты, на которых в первую очередь повлияют новые квоты использования. Мы обсудили наш анализ с ORCID Совет директоров, рассматривающий различные сценарии, принимая во внимание стратегические, рисковые и акционерные последствия каждого из них. Квоты использования, изложенные ниже, были одобрены Советом директоров на его заседании в сентябре 2024 года.
API Traffic Management помогает ORCIDСообщество вносит справедливый вклад в наше устойчивое развитие
ORCIDТекущий лимит скорости составляет 24 запроса в секунду для API Member, Public и Anonymous. В настоящее время нет квот использования для любого из наших API.
В феврале 2025 года мы начнем внедрять ежедневные квоты использования и изменим ограничение скорости для публичных и анонимных API следующим образом:
| Новые ограничения API | Анонимный API | Публичный (зарегистрированный) API | Членский API — Без изменений |
| Предел скорости | 12 запросов / сек | 12 запросов / сек | 24 запросов / сек |
| Квота использования | 25 тыс. прочтений/день (По IP-адресу) | 100 тыс. прочтений/день (по идентификатору клиента) | Нет квоты использования |
Квота на использование анонимного API будет вводиться поэтапно в течение нескольких месяцев, чтобы дать клиентам время адаптироваться.
Мы ожидаем, что это затронет менее 50 наших анонимных и публичных клиентов API (из 5,700 активных интеграций!). Мы не будем вводить квоту использования для нашего API-интерфейса Member, а ограничение скорости останется неизменным. Это означает, что ORCID Организации-участники, в полной мере использующие наш текущий лимит скорости, по-прежнему смогут делать почти 2 млн запросов в день, что значительно превышает закономерности использования, выявленные в ходе нашего анализа, поэтому мы не ожидаем, что кто-либо из наших участников столкнется с какими-либо перебоями.
ORCID всегда будем предоставлять наш ежегодный Файл общедоступных данных бесплатно для любого желающего, однако крайне важно, чтобы мы обеспечили справедливый и равноправный доступ к данным, содержащимся в ORCID реестр сейчас и в будущем. Пересмотр нашего подхода к управлению трафиком API является одной из частей этого. В октябре мы обновили наш «Условия обслуживания публичных API» (ранее известные как «Условия обслуживания публичных клиентов»), которые дополнительно определяют условия использования как для наших публичных, так и для анонимных API. В нем мы:
- Уточнено, что условия применяются как к нашим анонимным (незарегистрированным), так и к публичным (зарегистрированным) API.
- Уточнено определение «коммерческого использования»
- Объяснено, что в дополнение к регулированию мы можем использовать ограничения скорости или применять квоты использования для управления трафиком к публичным API.
- Объяснено, что при доступе к публичным API необходимо соблюдать установленные нами ограничения по скорости и квоты использования.
- Объяснены обстоятельства, при которых мы согласимся передать ваши учетные данные Public API вашей организации через Member API.
- Разъяснены обстоятельства, при которых вы можете использовать данные, полученные из публичных API, для маркетинговых коммуникаций в целях соблюдения правил конфиденциальности.
- Добавлено примечание относительно статуса переводов Условий обслуживания.
Мы призываем некоммерческих пользователей нашего анонимного API, чье использование превышает 25 тыс. чтений в день, но ниже 100 тыс. чтений в день, зарегистрироваться для получения бесплатного ключа открытого API через свой аккаунт My ORCID страница. Это позволит нам лучше понять, кто использует наши API в больших объемах, и связаться с ними, если их использование достигнет уровня, на котором это может повлиять на других пользователей Public API. Для тех организаций, которые используют наши API в некоммерческих целях более 100 тыс. чтений в день, и для всех коммерческих API-доступов, мы призываем вас рассмотреть возможность присоединения ORCID как организационный член, который предлагает множество других преимуществ, включая синхронизацию в реальном времени с ORCID общедоступный файл данных, а также доступ через API без квот использования и с щедрым ограничением скорости.
Внедряя скромные квоты использования и корректируя ограничение скорости для клиентов Anonymous и Public API, мы уверены, что сможем поддерживать целостность и доступность наших услуг — даже при росте спроса — таким образом, чтобы обеспечить нашу долгосрочную устойчивость и облегчить нашу возможность предоставлять справедливый доступ к нашим данным. Если у вас есть какие-либо комментарии или вопросы о предстоящих изменениях для пользователей Public или Anonymous API или обновлениях Условий обслуживания Public API, пожалуйста, не стесняйтесь размещать их в нашем Форум группы пользователей API.
