View source for API/ru

<languages/>
API работает через HTTP-запрос GET, поэтому вы можете работать со своим сервером Larnitech из браузера, просто отправляя запросы из адресной строки.
Запрос:
<syntaxhighlight lang="xml" line>
http://IPADDR:PORT/JSON_REQUEST
</syntaxhighlight>
Где:
IPADDR – IP адрес вашего модуля METAFORSA или DE-MG;
PORT – порт для плагина API (вы можете найти его в программе LT Setup. В разделе Плагины (Plugins) найдите плагин API и нажмите кнопку Настроить (Configure)).
JSON_REQUEST – запрос к серверу в формате json.
Поля запроса JSON_REQUEST:
<ul>
 	<li>"requestType" - тип запроса:
<ul>
 	<li>“getDevicesList” – запрос на получение списка всех устройств;</li>
 	<li>“getDeviceStatus” – запрос на получение статуса устройства;</li>
 	<li>“setDeviceStatus” – запрос на установку статуса устройства;</li>
        <li>“setDeviceStatusRaw” – запрос на установку статуса устройства (статус в шестнадцатеричном формате);</li>
 	<li>“getAllDevicesStatus” – запрос на получение статуса всех устройств.</li>
       
</ul>
</li>
 	<li>“key” – ключ для плагина API (его можно получить в программе LT Setup. В разделе Плагины (Plugins) найдите плагин API и нажмите кнопку Настроить (Configure)).</li>
 	<li>“addr” – адрес устройства.</li>
 	<li>“status” – статус устройства.</li>
</ul>
Примеры запросов и ответов:

<syntaxhighlight lang="json" line>
request:
{"requestType":"getDevicesList","key":"0000000000000000"}
 
response:
{
    "requestType":"devicesList",
    "devices": [
        {
            "type": "lamp",
            "name": "Ceiling",
            "addr":"401:1"
        },
                       
        {
            "type": "conditioner",
            "name": "AC",
            "addr":"158:200",
            "t-min":"16",
            "t-delta":"16"
        }
 
        ]
}
 
request:
{"requestType":"getDeviceStatus","addr":"310:1","key":"0000000000000000"}
response:
{
   "requestType" : "deviceStatus",
   "status" : {
      "addr" : "310:1",
      "state" : "middle",
      "type" : "jalousie"
   }
}
 
request:
{"requestType":"setDeviceStatus","addr":"310:1","key":"0000000000000000","status":{"state": "on"}}
 
response:
{
  "requestType":"setDeviceStatus",
  "addr":"410:1",
  "status":{
    "state": "on"
  }
   
}
 
request:
{"requestType":"getAllDevicesStatus","key":"0000000000000000"}
 
response:
{
    "requestType":"allDevicesStatus",
    "statuses": [
      {
        "addr":"401:1",
        "state": "off",
      },
       
      {
        "addr":"158:200",
        "state": "on",
        "temp":"25",
        "mode":"cool",
        "fan":"low",
        "vane-ver":"1",
        "vane-hor":"4"
      }  
        ]
}
 
request:
{"requestType":"setDeviceStatusRaw","addr":"310:1","key":"0","status":{"state":"ff00"}}
 
response:
{
   "addr" : "310:1",
   "key" : "0",
   "requestType" : "setDeviceStatusRaw",
   "status" : {
      "state" : "ff00"
}
</syntaxhighlight>