Модернизация REST API — настройка обратного прокси

Интерфейс PLCnext REST — это фантастический инструмент как для представления, так и для получения данных из серверной системы. REST, или передача репрезентативного состояния, представляет собой стиль архитектуры программного обеспечения, состоящий из рекомендаций и передовых методов создания масштабируемых веб-сервисов. На информационном портале PLCnext уже есть много полезной информации, обязательно ознакомьтесь с ней! URI, предоставляемые прошивкой PLCnext, идеально подходят, если вы можете построить свою систему с нуля. Однако они не идеальны, если вы хотите модифицировать существующий интерфейс REST на PLCnext. Этот блог покажет вам, как настроить свои собственные URI и связать их с вашими переменными с помощью обратного прокси-сервера. Мы начнем с создания небольшого примера и будем работать с ним!

Предпосылки

Я использую контроллер AXC F 2152 с FW2020.6 и PLCnext Engineer 2020.6. Но то же самое должно быть возможно с предыдущими версиями позже 2020.0. Я буду использовать PuTTY для установки SSH-соединения и postman для обработки HTTP-запросов. Я отключил аутентификацию в целях разработки, вы не должны делать то же самое в рабочей среде! Инструкции для PLCnext Engineer будут даны на очень высоком уровне, не знаете, что делать? Взгляните на информационный портал PLCnext и видеоролики с инструкциями и/или сравните с примером проекта! Контроллер, который я использую, имеет IP-адрес 192.168.10.10, измените его на IP-адрес, который вы используете.

Пример

В этом блоге в качестве примера я буду использовать простой насос UDT. Вы можете скачать образец программы с этой страницы GitHub или, конечно же, создать свой собственный. Отключите использование «управления пользователями» в настройках eHMI и создайте глобальную переменную. Используйте эту переменную на странице eHMI, чтобы мы могли использовать ее в API.

Первый вызов API

Может быть, мы должны сначала выяснить, что именно мы меняем через несколько минут!
Давайте отправим запрос GET, чтобы получить значение нашего первого насоса.

Используйте Postman для отправки запроса GET на следующий URI:

06

(Вы можете изменить Pump1 на свою собственную переменную)

Результат:

15 
Настройка пользовательской конечной точки
 

 Откройте сеанс оболочки, создайте пароль root и войдите в систему как пользователь root. 
 Затем введите следующую команду в своем терминале, перейдите в «низ» терминала и будьте осторожны, чтобы ничего не набирать в это время!
 
23
 

 Скопируйте и вставьте следующую часть в терминал и сохраните, нажав ctrl + s, и закройте, нажав ctrl + x.
 
37
 
Отправка запроса на новую конечную точку
 

 Отправьте новый запрос GET с почтальоном, на этот раз на следующий URI:
 

 ПОЛУЧИТЬ https://192.168.10.10/Pump1
 

 Получил такой же ответ? Поздравляем, прокси успешно настроен!
 
Настройка нескольких насосов
 

 Хорошо, но что, если у меня несколько помп? Что ж, один из подходов может заключаться в том, чтобы сделать массив, в котором дома находятся насосы UDT. Вы можете получить весь массив, вызвав переменную или только интересующий вас элемент, указав нужный индекс в правых скобках, например, Pump2[1] даст вам элемент с индексом 1 в массиве с именем Pump2. 

 Но это тема этого блога. Мы также можем настроить прокси таким образом, чтобы получить доступ к нескольким насосам. 
 Измените текст, вставленный на предыдущих шагах, чтобы он соответствовал следующей схеме:
 
45
 

 Отправка запроса GET с почтальоном на первый URI даст вам то же самое, что и раньше. Отправка запроса GET на второй URI даст вам массив данных того же типа.
 
53
 
66
 

 Теперь у вас должно быть все, чтобы соответствовать любой схеме API, с которой вы сталкиваетесь, и вы можете интегрировать ее в свое устройство PLCnext!
 
Дополнительная литература
 https://www.howtogeek.com/343877/what-is-an-api/https://www.w3schools.com/tags/ref_httpmethods.asphttps://medium.com/@TebbaVonMathenstien/what-is-an -api-and-why-should-i-use-one-863c3365726bhttps://restfulapi.net/rest-api-design-tutorial-with-example/ 

            


            

               Регистрация данных в IEC 61131-3:загрузка SFTP на основе мощности Curl         
                Доступ к веб-серверу PlcNext по DHCP