Это руководство проведет вас через чтение общедоступной информации и информации с ограниченным доступом на ORCID запись с использованием общедоступного или членского API. Он основан на версии 3.0 ORCID схема сообщения.
Получите некоторые учетные данные клиента
Учетные данные клиента - это имя пользователя и пароль, которые ваше приложение / веб-сайт будет использовать для доступа к ORCID API. Любой может зарегистрироваться для получения учетных данных Public API только для чтения, ORCID участники могут зарегистрироваться для членского API.
Мы рекомендуем разработчикам протестировать общедоступный API в сервер тестирования песочницы перед использованием рабочей версии. Ниже приведены шаги по регистрации для получения учетных данных общедоступного API как в тестовой среде, так и в рабочей среде.
- Войдите в свой ORCID запись:
Производственный сервер: https://orcid.org/signin
Сервер тестирования песочницы: https://sandbox.orcid.org/signin - Нажмите на свое имя в правом верхнем углу.
- Нажмите Инструменты разработчика из пункта меню
Примечание: Чтобы получить доступ к инструментам разработчика, вы должны подтвердить свой адрес электронной почты. Если вы еще не подтвердили свой адрес электронной почты, вам будет предложено сделать это на этом этапе. - Нажмите «Зарегистрироваться бесплатно» ORCID общедоступный API».

- Прочтите и примите условия обслуживания, когда будет предложено.

Зарегистрируйте заявку
- После принятия условий использования вы будете перенаправлены обратно в Инструменты разработчика (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools). Заполните представленную форму, чтобы зарегистрировать новое приложение.
- Имя и фамилия: Имя вашего приложения. Это будет показано пользователям, когда они предоставят вашему приложению разрешение на получение своих ORCID iD, и он будет отображаться в их Список доверенных организаций. Мы рекомендуем использовать название вашей организации или службы (например, название журнала).
- Cайт: Веб-сайт, который пользователь может посетить, чтобы узнать больше о вашем приложении. Это будет отображаться в их Список доверенных организаций.
- Описание: Информация о приложении, которое вы разрабатываете, и о том, как вы будете использовать пользовательский ORCID я бы. Это будет отображаться для пользователей на экране OAuth.

- Перенаправить URI: как только пользователь авторизует ваше приложение, он будет возвращен на указанный вами URI. Вы должны указать эти URI заранее, иначе ваши пользователи интеграции столкнутся с ошибкой.
- Только URI HTTPS принимаются в производство.
- Домены зарегистрированы ДОЛЖЕН точно соответствуют используемым доменам, включая субдомены.
- Зарегистрируйте все URI перенаправления полностью, где это возможно Это самый безопасный вариант, который мы рекомендуем. Для получения дополнительной информации об URI перенаправления см. FAQ
- В общедоступных приложениях API должен быть зарегистрирован хотя бы один URI перенаправления.
- Для тестирования вы можете автоматически добавить URI Google OAuth Playground, щелкнув «+ Google OAuth Playground» в разделе «Проверить URI перенаправления» или ORCID Публичный API Swagger, нажав «+»ORCID публичный чванливый интерфейс ».
- Для получения дополнительной информации см. О перенаправлении URI.
- Щелкните значок Сохранить внизу формы, чтобы сгенерировать учетные данные API.

- Чтобы просмотреть свои учетные данные API, нажмите «Показать подробности».

- Ваши учетные данные API - Клиент ID и Client Secret - отображаются сразу под вашими URI перенаправления. Ниже ваших учетных данных приведены примеры URL-адресов и вызовов API с предварительно заполненными учетными данными.

Используйте свои учетные данные
Теперь, когда у вас есть учетные данные, пора начать использовать ORCID Публичный API!
Обратите внимание, что мы можем передать ваши учетные данные членскому API, если вы станете ORCID член.
Вы можете запросить учетные данные API участника тестовой среды для сборки и тестирования вашего приложения. Эти учетные данные позволяют выполнять вызовы API-интерфейса члена песочницы для чтения, записи и обновления. ORCID записи. Доступ к тестовой среде "песочницы" доступен каждому, даже если вы не являетесь ORCID членская организация.
Внимание: Если вы используете стороннюю систему, которая уже поддерживает ORCID, возможно, вам не потребуется регистрироваться для получения учетных данных API песочницы.
Песочница позволяет вам создавать тестовые учетные записи пользователей и развивать свою интеграцию, не беспокоясь о влиянии данных на живые (производственные) ORCID Реестр. Песочница ведет себя так же, как и продакшн. ORCID Реестр с несколько исключений.
Создание тестовой учетной записи
Чтобы проверить ORCID API и вызовы API, такие как чтение и добавление информации в ORCID запись, вам также потребуется создать тест ORCID запись в песочнице. Это можно сделать через пользовательский интерфейс, как на продакшене. ORCID Реестр. Перейти к https://sandbox.orcid.org/register и зарегистрируйте аккаунт.
Адреса электронной почты Mailinator
Сервер песочницы отправляет уведомления по электронной почте только Mailinator Адреса электронной почты (@mailinator.com), чтобы непреднамеренно не спамить почтовые серверы. Вы не получите электронное письмо с подтверждением или уведомление о сбросе пароля, если не используете адрес @mailinator.com, а проверка требуется для внесения любых изменений в записи песочницы вручную. Узнайте больше об их бесплатных общедоступных почтовых ящиках здесь. Если вы не хотите использовать Mailinator адрес, затем запишите свое имя пользователя и пароль (поскольку вы будете использовать их для авторизации вашего приложения при тестировании) и свяжитесь с нами, чтобы запросить помощь с проверкой.
Mailinator это служба электронной почты, которая имеет общедоступную бесплатную услугу и частную платную услугу. Для тестирования вы можете воспользоваться совершенно бесплатным публичным сервисом. Узнайте больше об их уровнях здесь.
Mailinator - это сторонний сервис, который не управляется и не поддерживается ORCID. Мы рекомендуем вам ознакомиться с принципами работы этой службы и ее ограничениями, прежде чем использовать эти адреса.
Получите токен доступа
Вам необходимо получить токен доступа, чтобы использовать ORCID API. Это делается с помощью OAuth. Обратите внимание, что:
- ORCID участники могут попросить отдельных исследователей разрешить читать «ограниченные» данные о видимости из их записей.
- Клиентам не нужно спрашивать разрешения исследователя на чтение общедоступной информации.
Любой человек с общедоступными учетными данными или учетными данными API может получить / read-public токен доступа. Чтобы получить токен, вы звоните в ORCID Конечная точка токена API.
Этот процесс часто называют потоком OAuth для учетных данных клиента или двухэтапным OAuth.
Пример вызова для получения токена доступа для чтения общедоступных данных в песочнице - замените заполнители своими учетными данными (обязательно удалите скобки.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
Затем вам будет возвращен токен доступа, подобный приведенному ниже. Возвращенный токен является долгоживущим (не истекает примерно 20 лет) и может использоваться несколько раз для получения общедоступных данных из ORCID Records.
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
записки: Все токены с областью / Authenticate теперь также имеют область / read-public. Если вы используете только область / Authenticate, вы можете использовать сохраненные токены доступа для чтения общедоступных данных без необходимости повторного получения токена доступа.
Чтобы получить / ограниченный доступ для чтения, вы должны спросить разрешения у исследователя. Вы делаете это с помощью OAuth. Конкретно, "Трехсторонний OAuth».
Для получения дополнительной информации, пожалуйста, посетите наш Учебное пособие по API: чтение данных на ORCID запись
ORCID интеграции используют «трехсторонний OAuth» для аутентификации пользователей и запроса разрешения на взаимодействие с их записями. Любая интеграция может запрашивать разрешения на чтение с помощью общедоступного API. ORCID участники могут использовать Member API для запроса разрешений на обновление. Это работает следующим образом:
- Вы создаете специальную ссылку
- При нажатии пользователь отправляется на ORCID
- ORCID просит пользователя войти в систему
- ORCID просит пользователя предоставить разрешение вашему приложению
- ORCID отправляет пользователя обратно в вашу систему с кодом авторизации
- Ваша система обменивает этот код на токен доступа
Настраиваемый URL-адрес авторизации включает информацию о вашем клиенте, а также «области действия», которые определяют определенные области их записи, к которым вы хотите получить доступ. После входа пользователь разрешает подключение к вашей системе и возвращается на вашу целевую страницу вместе с кодом авторизации. Затем этот код используется для получения их ORCID iD вместе с токеном доступа, действительным для запрошенных областей.
Вы создаете свою ссылку для авторизации, указав клиент учетных данных вашего API ID и связанная целевая страница (URI перенаправления). Вы выбираете, какие разрешения запрашивать, устанавливая параметр области.
В приведенном ниже примере запрашивается разрешение на чтение данных с ограниченным доступом на ORCID тестовый сервер в песочнице. В реальном мире вы показываете эту ссылку на своем веб-сайте или включаете ее в электронное письмо, когда просите пользователя пройти аутентификацию и авторизацию. Однако в целях тестирования вы можете просто вставить его в свой веб-браузер. Замените данные в квадратных скобках информацией о вашем клиенте и обязательно удалите квадратные скобки!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
После того, как пользователь щелкнул ссылку, вошел в систему на ORCID и предоставленные разрешения они перенаправляются обратно на ваш сайт, например:
https://[Your landing page]?code=Q70Y3A
Вам следует немедленно обменять код авторизации на ORCID iD и токен доступа. Срок действия кода авторизации истекает после использования. Запрос выглядит так и нельзя сделать в веб-браузере, это должен сделать ваш сервер.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID затем вернет проверенные исследователем ORCID iD и токен доступа в формате JSON:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
По умолчанию токены доступа имеют долгий срок действия и истекают через 20 лет после выпуска. Токен можно использовать несколько раз до истечения срока его действия.
Используйте токен доступа
Токены трехстороннего доступа связаны с конкретными ORCID записывать. Чтобы использовать их, вы включаете их в запросы API, которые вы делаете для чтения или обновления этой записи.
Видимость указывает настройку конфиденциальности элемента, основанную на настройках видимости, заданных пользователем. Если тег видимости включен при публикации информации через API, он будет проигнорирован. Скорее, информация будет публиковаться в соответствии с настройками видимости пользователя по умолчанию, установленными в настройках его учетной записи.
Публичные элементы могут быть прочитаны кем угодно через API и отображаются в общедоступной записи исследователя. Элементы доверенной стороны возвращаются через API только клиентам, имеющим доступ с ограничением чтения; они не находятся в открытом доступе исследователя. Частные элементы видны только исследователю и источнику элемента — единственные частные элементы, возвращаемые через API, — это те, которые были добавлены в запись через вашу интеграцию. Подробнее о настройках видимости в ORCID реестра.
Решите, что вы хотите прочитать
Наблюдения и советы этой статьи мы подготовили на основании опыта команды ORCID запись разделена на множество разделов. Вы можете прочитать все резюме или только те части, которые вас интересуют.
Этот пример вызова извлекает сводку полного ORCID запись в формате XML с использованием членского API на сервере песочницы. Вам нужен токен доступа, чтобы делать запросы API к общедоступному или членскому API.
Method: GET Accept: application/vnd.orcid+xml
Authorization type and Access token:
Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
API вернет сообщение 200 OK, указывающее, что запрос был успешно получен, и полный обзор ORCID записи, включая сводки по отдельным пунктам.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Каждый элемент (работа, финансирование, занятость и т. Д.) Имеет поставить код. При необходимости его можно использовать для получения полной информации об элементе.
Наблюдения и советы этой статьи мы подготовили на основании опыта команды ORCID Запись разделена на отдельные разделы, чтобы сделать чтение записи более быстрым и последовательным. Вы можете сначала вызвать раздел, чтобы получить его сводку, а затем вызвать, используя код размещения отдельного элемента, чтобы получить надежную информацию об этом элементе.
Таблица сводных разделов, для чтения которых вы можете использовать API, приведена ниже.
Конечная точка | Описание |
/записывать | Сводный вид полного ORCID запись |
/человек | Биографический раздел ORCID запись, в том числе URL-адреса / исследователя ниже |
/адрес | Страны или регионы исследователя |
/электронное письмо | Адрес (а) электронной почты, связанный с записью |
/ внешние идентификаторы | Связанные внешние идентификаторы в других системах |
/ ключевые слова | Ключевые слова, связанные с исследователем и его работой |
/Другие названия | Другие имена, под которыми известен исследователь |
/личные данные | Личные данные: имя исследователя, кредитное (опубликованное) имя и биография. |
/ исследователь-urls | Ссылки на личные или профильные страницы исследователя |
/виды деятельности | Краткое изложение раздела мероприятий ORCID запись, в том числе через / работает ниже. |
/ образование | Принадлежность к образованию |
/ вакансии | Принадлежность к трудоустройству |
/ финансирование | Резюме финансовой деятельности |
/ peer-reviews | Резюме деятельности по экспертной оценке |
/работает | Резюме исследовательских работ |
/ исследования-ресурсы | Резюме исследовательских ресурсов |
/Сервисы | Краткое описание услуг |
/ квалификация | Резюме квалификаций |
/ членство | Резюме членства |
/ различия | Резюме различий |
/ приглашенные должности | Резюме приглашенных должностей |
Используйте токен для доступа к API
Теперь у вас есть токен доступа, и вы можете выполнить вызов API, чтобы получить данные в формате XML или JSON.
Все предметы (кроме текста биографии) на ORCID запись есть поставить код:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
Этот код размещения можно использовать для вызова API для получения полных данных для элемента. Следующие элементы можно запросить с помощью поставить код:
Конечная точка | Описание |
/ адрес / [введите код] | Отдельная страна или регион |
/биография | Поле биографии: область с произвольным текстом, которую может редактировать только исследователь. |
/ education / [введите код] | Индивидуальный элемент принадлежности к образованию |
/ email / [введите код] | Индивидуальный адрес электронной почты, связанный с записью |
/ занятость / [код ввода] | Элемент индивидуальной занятости |
/ external-identifier / [код ввода] | Индивидуальный связанный внешний идентификатор в другой системе |
/ финансирование / [код ввода] | Индивидуальное финансирование |
/ ключевые слова / [введите код] | Индивидуальное ключевое слово, связанное с исследователем и его работой. |
/ other-names / [введите код] | Индивидуальное дополнительное имя, под которым известен исследователь |
/ peer-review / [ввести код] | Индивидуальная экспертная оценка |
/ research-urls / [введите код] | Индивидуальная внешняя ссылка на личную или профильную страницу исследователя |
/ work / [введите код] | Индивидуальная исследовательская работа |
/ works / [введите код1], [введите код2], [введите код3] | Массовые отдельные исследовательские работы (до 100) |
Используя конечную точку раздела и поместив код, вы можете вызвать API, используя тот же токен доступа, чтобы получить этот конкретный элемент полностью. Этот пример вызова извлекает полную статью финансирования 4413 в формате XML с помощью API-интерфейса участника на сервере песочницы.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
API вернет сообщение 200 OK, чтобы указать, что сообщение было успешно получено, и вернет полный XML элемента финансирования:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
Вы можете проверить источник предмета при чтении, если вы хотите знать, кто это добавил.
Больше информации
Примечание о группировке
Элементы сгруппированы вместе на ORCID записи на основе их идентификаторов. Вы можете обнаружить, что элементы, которые вы читаете, являются частью группы.
Работает в ORCID сгруппированы вместе на основе как их идентификаторов, так и отношения этих идентификаторов к произведению. Существует четыре типа отношений:
- Сам: идентификатор относится исключительно к этой работе и может быть сгруппирован с другими произведениями, имеющими такой же идентификатор.
- Часть: произведение является частью этого идентификатора и не может быть сгруппировано с другими произведениями.
- Версия: эти идентификаторы применяются к альтернативным версиям произведения и могут быть сгруппированы с собственными идентификаторами и версиями.
- Спонсируемый: эти идентификаторы относятся к финансированию работы. Эти идентификаторы не используются для группировки работ.
Наш API поддерживает это в XSD. Каждый элемент имеет атрибут индекса отображения, который указывает его ранг в группе. Наивысший индекс отображения - это предпочтительный элемент, выбранный исследователем, элементы, добавленные через API, которые не были ранжированы исследователем, имеют индекс отображения 0. Индекс отображения также определяет порядок работы при чтении ORCID записи.
Для получения дополнительной информации о группировке по ORCID записи, пожалуйста, посмотрите наши вспомогательная статья.
Примечание о типах контента
ORCID поддерживает несколько типов контента, включая XML и несколько разновидностей JSON. Вы можете запросить предпочтительный тип, включив «Заголовок Accept» в свои запросы API. Это называется «согласование контента».
Наблюдения и советы этой статьи мы подготовили на основании опыта команды ORCID Реестр поддерживает «согласование содержимого». Это означает, что машины и другие системы могут запрашивать ORCID реестр метаданных человека в разных форматах.
Одним из таких форматов является JSON-LD, в котором используется schema.org словарный запас, в частности Тип человека, которые мы связываем с работами, организациями и другими идентификаторами. Мы также поддерживаем XML, JSON, RDF XML и turtle, а также реализовали совместное использование ресурсов между источниками (CORS), чтобы упростить доступ к нашим данным.
- См. этот сообщение в блоге с обзором ORCID и schema.org
- Смотрите наши техническая документация по согласованию контента
Примечание о несуществующих ORCIDs
Поиск пользователя с помощью cURL:
curl -iL https://orcid.org/0000-0000-0000-0000
Вернет 200, даже если пользователь не существовать. Чтобы этого избежать, используйте в вызове согласование содержимого следующим образом:
curl -iL -H 'Accept: application/xml' https://orcid.org/0000-0000-0000-0000