Обучение rest api

Учебный центр R-Service

Прогресс прохождения курса

77%

Упражнение 7. REST API – Обновление объекта

Давайте попробуем выполнить обновление в R-Service. В этом упражнении вы переименуете команду ‘Операции' в учетной записи Widget Data Center.

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

При выполнении обновления вам необходимо определить новое значение (значения) в разделе данных (или теле) запроса API. Данные должны быть отформатированы в формате JSON. Это означает, что вы будете определять поля, которые необходимо обновить, как пары значений:
{"field-1":"value1","field-2":"value2"}

При использовании CURL в операционной системе Windows важно избегать двойных кавычек в параметре -d (т.е. data) следующим образом: -d «{\"param»:\"value\"}"

В этом упражнении вы также будете использовать строку запроса. Строка запроса является частью URL. В REST API строка запроса используется для указания параметров для точной настройки запроса для объектов данных.

Строка запроса отображается после вопросительного знака (?) в конечной точке. В строке запроса каждый параметр указан один за другим с разделяющим их символом амперсанда (&). Порядок параметров строки запроса не имеет значения.

R-Service REST API позволяет фильтровать список записей с помощью строки запроса. Например, следующий оператор CURL вернет все элементы конфигурации в Widget Data Center:

curl -X GET -i -H «Authorization: Bearer <personal-token>» -H «X-4me-account: wdc» «https://api.demo.rrtsm.ru/v1/cis»

Если вам нужен только список элементов конфигурации с label = ‘CMP00001', вы можете добавить этот фильтр в виде строки запроса к URL следующим образом:

curl -X GET -i -H «Authorization: Bearer <personal-token>» -H «X-4me-account: wdc» «https://api.demo.rrtsm.ru/v1/cis?label=CMP00001»

Вы не можете использовать все символы в URL-адресе: URL-адреса могут быть отправлены через Интернет только с использованием набора символов ASCII. Поскольку URL-адреса часто содержат символы, не входящие в набор ASCII, URL-адрес должен быть преобразован в допустимый формат ASCII. Кодировка URL-адреса заменяет небезопасные символы ASCII символом «%», за которым следуют две шестнадцатеричные цифры. Например, пробелы заменяются на %20 в HTTP-запросах.

Телефон

+7 (495) 231-73-64

E-mail

office@rr-th.com

Адрес

Москва, Цветной бульвар д. 26, стр. 1, офис 36

Разработка российского программного обеспечения