API - Список словарей — различия между версиями

Материал из WebHMI Wiki
Перейти к: навигация, поиск
Строка 34: Строка 34:
 
   {
 
   {
 
     "id": "1",
 
     "id": "1",
     "title": "Внутренние регистры",
+
     "title": "Рецепты",
     "addr": "",
+
     "value": "1,Green Tea<br>2,Black Tea<br>3,Lemon Grass"
    "baudrate": "9600",
+
    "parity": "e",
+
    "stopbit": "1",
+
    "bitscount": "8",
+
    "model": "3",
+
    "protocol": "4",
+
    "timeout": "100",
+
    "timeout2": "",
+
    "device": "/dev/rs485",
+
    "disabled": "0",
+
    "mode": "0"
+
 
   },
 
   },
 
   {
 
   {
 
     "id": "2",
 
     "id": "2",
     "title": "S7 200",
+
     "title": "Режим подогрева",
     "addr": "2",
+
     "value": "0,Выкл.<br>1,Вкл.<br>2,Авария"
    "baudrate": "9600",
+
    "parity": "e",
+
    "stopbit": "1",
+
    "bitscount": "8",
+
    "model": "1",
+
    "protocol": "3",
+
    "timeout": "200",
+
    "timeout2": "",
+
    "device": "/dev/rs485",
+
    "disabled": "1",
+
    "mode": "0"
+
 
   }
 
   }
 
]
 
]
Строка 69: Строка 47:
  
  
Пример запроса информации об соединений номер 2:
+
Пример запроса информации о словаре номер 2:
  
'''URL''': http://192.168.1.1/api/connections/2<br>
+
'''URL''': http://192.168.1.1/api/dictionaries/2<br>
 
'''Method''': GET
 
'''Method''': GET
  
Строка 79: Строка 57:
 
Content-Type: application/json
 
Content-Type: application/json
 
Accept-Encoding: gzip, deflate, sdch
 
Accept-Encoding: gzip, deflate, sdch
X-WH-APIKEY:F3C74230818DA487BB2017CE5D0290F4DABCAFD7
+
X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7
 
</pre>
 
</pre>
  
Строка 86: Строка 64:
 
{
 
{
 
   "id": "2",
 
   "id": "2",
   "title": "S7 200",
+
   "title": "Режим подогрева",
   "addr": "2",
+
   "value": "0,Выкл.<br>1,Вкл.<br>2,Авария"
  "baudrate": "9600",
+
  "parity": "e",
+
  "stopbit": "1",
+
  "bitscount": "8",
+
  "model": "1",
+
  "protocol": "3",
+
  "timeout": "200",
+
  "timeout2": "",
+
  "device": "/dev/rs485",
+
  "disabled": "1",
+
  "mode": "0"
+
 
}
 
}
 
</pre>
 
</pre>
Строка 104: Строка 71:
  
  
Атрибуты соединения:
+
Атрибуты словаря:
  
 
<table>
 
<table>
<tr><td>'''id'''</td><td>int</td><td>Уникальный идентификатор соединения</td></tr>
+
<tr><td>'''id'''</td><td>int</td><td>Уникальный идентификатор словаря</td></tr>
<tr><td>'''title'''</td><td>string</td><td>Название соединенеия</td></tr>
+
<tr><td>'''title'''</td><td>string</td><td>Название словаря</td></tr>
<tr><td>'''addr'''</td><td>string</td><td>Адрес устройства на шине или сетевой адрес для TCP соединения</td></tr>
+
<tr><td>'''value'''</td><td>string</td><td>Содержание словаря. Записи словаря разделены тегом &lt;br&gt;. Каждая запись содержит пару ключ-значение разделенные запятой. Например: 1,Green Tea. Это значит что при значении регистра = 1 будет отображаться строка "Green Tea"</td></tr>
<tr><td>'''baudrate'''</td><td>int</td><td>Скорость обмена данными для последовательных соединений</td></tr>
+
<tr><td>'''parity'''</td><td>string</td><td>Контроль четности для последовательных соединений. e = Even, o = Odd, n = None</td></tr>
+
<tr><td>'''stopbit'''</td><td>int</td><td>Количество стоповых битов для последовательных соединений</td></tr>
+
<tr><td>'''model'''</td><td>int</td><td>Идентификатор типа устройства</td></tr>
+
<tr><td>'''protocol'''</td><td>int</td><td>Идентификатор протокола обмена</td></tr>
+
<tr><td>'''timeout'''</td><td>int</td><td>Максимальное время ожидания ответа на запрос от устройства</td></tr>
+
<tr><td>'''device'''</td><td>string</td><td>Системное имя адаптера для последовательных соединений</td></tr>
+
<tr><td>'''disabled'''</td><td>int</td><td>0 = соединение активно, 1 = соединение отключено</td></tr>
+
<tr><td>'''mode'''</td><td>int</td><td>0 = норальный режим работе. 1 = режим Virtual UART</td></tr>
+
 
</table>
 
</table>
----
 
 
 
Идентификаторы типа устройства:<br>
 
0 = Delta DVP<br>
 
1 = Siemens Simatic S7 200<br>
 
2 = Generic ModBus<br>
 
3 = Internal WebHMI Registers<br>
 
4 = Generic Owen<br>
 
5 = Generic DF1<br>
 
----
 
 
 
Идентификаторы протокола обмена:<br>
 
0 = ModBus ASCII<br>
 
1 = ModBus RTU (еще не доступен)<br>
 
2 = ModBus TCP<br>
 
3 = Siemens PPI<br>
 
4 = Owen<br>
 
5 = Allen Bradley DF1<br>
 
6 = Internal WebHMI Registers<br>
 

Версия 10:22, 31 января 2015

Для получения списка всех словарей необходимо выполнить GET-запрос на URL вида http://192.168.1.1/api/dictionaries.

Для получения информации о конкретном словаре необходимо выполнить GET-запрос на URL вида http://192.168.1.1/api/dictionaries/1. Здесь 1 - это ID нужного словаря.

В заголовках запроса ноебходимо передать API key. Например:

X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7

Также в заголовках необходимо указать желаемый формат обмена данными. Сейчас поддерживатеся работа только с форматом JSON.

Accept: application/json
Content-Type: application/json


Пример запроса списка всех словарей:

URL: http://192.168.1.1/api/dictionaries
Method: GET

Заголовки:

Accept: application/json
Content-Type: application/json
Accept-Encoding: gzip, deflate, sdch
X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7

Пример ответа:

[
  {
    "id": "1",
    "title": "Рецепты",
    "value": "1,Green Tea<br>2,Black Tea<br>3,Lemon Grass"
  },
  {
    "id": "2",
    "title": "Режим подогрева",
    "value": "0,Выкл.<br>1,Вкл.<br>2,Авария"
  }
]


Пример запроса информации о словаре номер 2:

URL: http://192.168.1.1/api/dictionaries/2
Method: GET

Заголовки:

Accept: application/json
Content-Type: application/json
Accept-Encoding: gzip, deflate, sdch
X-WH-APIKEY: F3C74230818DA487BB2017CE5D0290F4DABCAFD7

Пример ответа:

{
  "id": "2",
  "title": "Режим подогрева",
  "value": "0,Выкл.<br>1,Вкл.<br>2,Авария"
}


Атрибуты словаря:

idintУникальный идентификатор словаря
titlestringНазвание словаря
valuestringСодержание словаря. Записи словаря разделены тегом <br>. Каждая запись содержит пару ключ-значение разделенные запятой. Например: 1,Green Tea. Это значит что при значении регистра = 1 будет отображаться строка "Green Tea"