Шаг 3 (из 5)

3. Напишите ORCID запись (ПОСТ)

Поздравляем! Вы все настроили и собираете идентификаторы и разрешения — теперь самое интересное! На этом уроке вы научитесь записывать данные в ORCID записи.

В этом разделе мы добавим принадлежность «Образование» к вашей записи в песочнице.

В следующем примере мы используем конечную точку /education с правильный XML чтобы добавить информацию, но вы также можете добавить, например, Занятость или Работы. Смотрите наш Документация Github для получения дополнительных примеров файлов и конечных точек, а также разрешений, необходимых для каждого из них.

Вот пример образования XML, который вы можете использовать для этого упражнения:

<?xml version="1.0" encoding="UTF-8"?>
<education:education
	xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">	
	<common:department-name>department-name</common:department-name>
	<common:role-title>role-title</common:role-title>
	<common:start-date>
		<common:year>1948</common:year>
		<common:month>02</common:month>
		<common:day>02</common:day>
	</common:start-date>
	<common:end-date>
		<common:year>1948</common:year>
		<common:month>02</common:month>
		<common:day>02</common:day>
	</common:end-date>
	<common:organization>
		<common:name>common:name</common:name>
		<common:address>
			<common:city>common:city</common:city>
			<common:region>common:region</common:region>
			<common:country>AF</common:country>
		</common:address>
		<common:disambiguated-organization>
            <common:disambiguated-organization-identifier>http://dx.doi.org/10.13039/100000001</common:disambiguated-organization-identifier>
			<common:disambiguation-source>FUNDREF</common:disambiguation-source>
        </common:disambiguated-organization>
	</common:organization>		
	<common:url>http://tempuri.org</common:url>  
	<common:external-ids>
        <common:external-id>
            <common:external-id-type>grant_number</common:external-id-type>
            <common:external-id-value>external-identifier-value</common:external-id-value>          
            <common:external-id-url>http://tempuri.org</common:external-id-url>
            <common:external-id-relationship>self</common:external-id-relationship>
        </common:external-id>
        <common:external-id>
            <common:external-id-type>grant_number</common:external-id-type>
            <common:external-id-value>external-identifier-value2</common:external-id-value>         
            <common:external-id-url>http://tempuri.org/2</common:external-id-url>
            <common:external-id-relationship>self</common:external-id-relationship>
        </common:external-id>
    </common:external-ids>
</education:education>

Вернитесь на вкладку браузера для Google Developers OAuth 2.0 Playground. Если вы не оставили вкладку открытой, вы можете повторно инициализировать сеанс с URL-адресом, который вы сохранили ранее (нажав «ОК» в появившемся предупреждении). Или вы можете снова настроить звонок, заполнив все соответствующие поля, убедившись, что они выглядят так, как показано на скриншотах ниже:

Убедитесь в том, конфигурация есть твой идентификатор клиента и секрет клиента

Ниже шага 2 на игровой площадке Google oauth у вас должен быть свой маркер доступа заполнен
Он должен либо по-прежнему иметь токен из предыдущего упражнения, либо вы можете заполнить его из предыдущего упражнения следующим образом:

Изображение, показывающее снимок экрана из Google Developers Outh 2.0 Playground со следующим текстом: Шаг 1. Выбор и авторизация API. Шаг 2. Обмен кода авторизации для токенов. обновления и токен доступа, необходимый для доступа к защищенным ресурсам OAth. Код авторизации: Код авторизации Код авторизации Exchange для токенов Обновить токен: Обновить токен Токен доступа: •Автоматическое обновление токена до истечения срока его действия. Обновить токен доступа Примечание. Площадка OAuth автоматически аннулирует токены обновления через 1 часа. Этого можно избежать, указав собственные учетные данные аутентификации приложения с помощью панели «Конфигурация».

Под шагом 3 на игровой площадке Google Developers OAuth 2 нажмите Добавить заголовки, введите значения ниже, затем нажмите Добавить и Закрыто

Header name: Accept

Header value: application/vnd.orcid+xml

Ниже Шаг 3: Настройка запросить в API, задавать HTTP-метод в ПОСЛЕ.

Снимок экрана с игровой площадки OAuth 2 для разработчиков Google, показывающий следующую информацию: Шаг 3. Настройте запрос к API. Создайте HTTP-запрос, указав URI, метод HTTP, заголовки, тип контента и тело запроса. Затем нажмите кнопку «Отправить запрос», чтобы инициировать HTTP-запрос. Метод HTTP: POST Добавить заголовки

В Запросить URI поле введите:

https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education

Заменять [ORCID ID] с iD для записи песочницы отформатируйте XXXX-XXXX-XXXX-XXXX, с которым вы получили разрешение на взаимодействие.

Нажмите Тип содержимого > На заказ и введите

application/vnd.orcid+xml

Нажмите Добавить, затем нажмите Закрыто.

Нажмите Введите тело запроса.

Скопируйте XML-код об образовании в верхней части этого раздела и вставьте его в Тело запроса текстовое окно:

ДОПОЛНИТЕЛЬНО: В Тело запроса текстовое поле, отредактируйте XML, чтобы он отражал ваше учреждение. За , использовать Реестр ROR чтобы найти идентификатор ROR для вашего учрежденияn.

Нажмите Закрыто.

Нажмите Отправить заявку.

Результаты появятся в Ответ на запрос раздел справа. Прокрутите до конца ответа — если вы видите HTTP / 1.1 201 Создано, ваше образование было успешно добавлено! Ниже вы можете увидеть выдержку из примера того, как XML будет выглядеть с созданным сообщением 201 внизу.

... <common: month>01</common: month> <common: day>01</common: day>
</ common: start-date> <education:organization>
<common: name>My University</common: name> <common: address>
<common: city>Some City</common:city> <common: region>Region</common: region> <common: country>US</common:country>
</ common: address>


HTTP/1.1 201 Created
Content length. A X-xss-protection: 1; mode=block X-content-type-options: nosniff
Expires: 0
Server: nginx/1.10.0
Connection: keep-alive
Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pragma: no-cache
Cache-control: no-cache, no-store, max-age=0, must-revalidate
Date: Thu, 15 Jun 2017 20:44:09 GMT
Access-control-allow-origin: *
Content-type: application/vnd.orcid+xml: qs=5;charset=UTF-8
X-frame-options: DENY

Пожалуйста, сохраните код ввода, он потребуется в следующем разделе для обновления элементов!

Сохраните свой put-код

Пут-коды — это короткие числовые коды, которые ссылаются на конкретный товар на бирже. ORCID записи.

Когда вы публикуете элемент в записи исследователя, ответ API будет содержать код размещения для этого элемента. Вы можете сохранить код размещения, чтобы использовать его позже, если вам нужно прочитать, обновить или удалить этот элемент.

В приведенном выше примере код ввода представляет собой 5 цифр в конце этой строки: Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971

Если в вашем ответе есть ошибка, проверьте, нет ли опечаток в ваших XML-тегах и правильно ли вы ввели все остальные данные. Малейшая опечатка может сломать все!

Посетите публичный просмотр вашей записи Sandbox по адресу https://sandbox.orcid.org/[ORCID ID], чтобы увидеть вашу новую образовательную принадлежность.

Обратите внимание, что Source показывает имя клиента API, который добавил принадлежность — это ключевой элемент, который помогает другим системам, использующим ORCID данные определяют, является ли эта часть информации достоверной.

3. Напишите ORCID запись (ПОСТ)

Шаги в этом руководстве