Июль знаменует собой пятый месяц с тех пор, как мы выпустили ORCID API v2.0, и мы рады сообщить, что многие пользователи Public и Member API уже обновили или находятся в процессе обновления. Чтобы воодушевить тех из вас, кто еще не приступил к обновлению, мы хотели бы выделить некоторые функции v2.0 это упростит ваши рабочие процессы, уменьшит размер передаваемых файлов и сделает вашу ORCID интеграция лучше работает как для вас, так и для ваших пользователей.
Меньше прицелов, меньше путаницы
Наш старый API позволил вам запросить много разрешения от пользователей: разрешение на создание элементов в разделе, чтение того же раздела и его обновление. Запросы отдельных разрешений для каждого раздела привели к появлению списка запросов, которые сбивали пользователей с толку.
В API v2.0 мы объединили наши объемы на три, которые позволяют запрашивать доступ для чтения (ограниченный) и обновления ко всем разделам ORCID записи.
У этих токенов все еще есть старые разрешения? Не волнуйтесь - они продолжат работать с теми уровнями доступа, для которых были изначально выданы. Но вы можете создать рабочий процесс, чтобы запрашивать у пользователей обновление своих разрешений, если ваша обновленная система имеет новые функции, включающие доступ к другим разделам их записи.
Читать и обновлять по элементам
Используя предыдущие версии API, если вашей системе нужно было добавить новую отдельную работу к записи, в которую вы добавили несколько работ, то ей пришлось обновить весь раздел работ, включая новую работу и все ранее добавленные работы. В результате обновление одного элемента в записи включало отправку потенциально большого файла с другими элементами, в которых не было изменений, или потерю всех элементов в этом разделе или даже всей записи.
v2.0 упростил этот процесс за счет управление предметами в индивидуальном порядке. Ваша система может добавить одну работу в ORCID запись, а затем отредактируйте или удалите эту единственную работу. Это делается путем реализации поставить коды для отдельных предметов на ORCID Реестр. Например, если ваша система добавляет новое место работы в ORCID запись, ORCID API возвращает подтверждающее сообщение вместе с кодом размещения, который ваша система может использовать только для обновления или удаления этого элемента. Как правило, только один элемент может быть добавлен, отредактирован или удален за раз на ORCID записи. Единственное исключение - работы, которые для многих исследователей составляют основную часть их ORCID записывать. API v2.0 позволяет вашим системам прочитать до 50 работ за раз, и чтобы добавить до 100 работ вовремя. Редактирование или удаление работ по-прежнему должно производиться по элементам.
Коды пут имеют обратную силу: всем элементам, добавленным в версии 1.2 и ранее, были присвоены коды пут. Работая над обновлением системы до версии 2.0, не забудьте добавить поле для соответствующего кода размещения. Вы можете запросить ORCID record, чтобы получить коды помещения для любых элементов, которые ваша система добавила в реестр, и соответствующим образом обновить свою базу данных, чтобы вы могли обновлять их в будущем по мере необходимости.
Читайте записи быстрее
API v2.0, как и предыдущий API, позволяет вашей системе прочитать отдельный раздел или всю запись за один звонок. Возвращаются не все данные в записи, а скорее сводное представление трех разделов, которые, как правило, являются самыми большими в записи. ORCID записи: работы, финансирование и экспертные оценки.
Независимо от того, читает ли ваша система полную запись или отдельный раздел, сводный вид этих действий отображается. Сводка содержит ограниченную информацию: например, сводка работ возвращает только название работы, тип, дату, ее уникальные идентификаторы и их связь с работой, индекс отображения для каждой версии элемента (если есть несколько версий), источник (пользователь или клиент API) и соответствующий код размещения для каждой версии элемента.
Сводные просмотры сокращают размер файлов и время передачи, снижая потенциальную нагрузку на нашу и вашу систему и ускоряя обновление.
И многое другое!
В версии 2.0 есть намного больше, чем можно порадоваться: гибкая поддержка внешних идентификаторов, добавление действий экспертной оценки, более четкое группирование нескольких версий действий, улучшенные результаты поиска по умолчанию и многое другое.
Хотите узнать больше? Присоединяйтесь к нам! Каждый месяц мы проводим вебинары в разных часовых поясах и на разных языках, а до конца года мы будем обсуждать обновление до API v2.0. Проверьте наши объявления на предмет следующегоили Контакты чтобы узнать больше.
Вы уже перешли на API v2.0? Расскажите нам о своем опыте!