Web API: различия между версиями

Материал из wiki.quadrobit.com
Перейти к навигации Перейти к поиску
(Отметить эту версию для перевода)
Строка 2: Строка 2:
 
<translate>
 
<translate>
  
 +
<!--T:1-->
 
* API v01 *
 
* API v01 *
  
 +
<!--T:2-->
 
API ( json )
 
API ( json )
  
 +
<!--T:3-->
 
URL https://quadrobit.com/
 
URL https://quadrobit.com/
  
= Учётная запись =
+
= Учётная запись = <!--T:4-->
 
== Авторизация (login) ==
 
== Авторизация (login) ==
  
 +
<!--T:5-->
 
request:
 
request:
  
 +
<!--T:6-->
 
Request URL: [site]/api/login
 
Request URL: [site]/api/login
  
 +
<!--T:7-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:8-->
 
(string) email,
 
(string) email,
  
 +
<!--T:9-->
 
(string) password
 
(string) password
  
 +
<!--T:10-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 29: Строка 38:
 
</pre>
 
</pre>
  
 +
<!--T:11-->
 
response:
 
response:
 
параметры ответа: (object)
 
параметры ответа: (object)
  
 +
<!--T:12-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 48: Строка 59:
 
}
 
}
  
 +
<!--T:13-->
 
</pre>
 
</pre>
  
  
== Регистрация (registration) ==   
+
== Регистрация (registration) == <!--T:14-->    
  
 +
<!--T:15-->
 
request:
 
request:
 
Request URL: [site]/api/registration
 
Request URL: [site]/api/registration
  
 +
<!--T:16-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:17-->
 
(string) email,
 
(string) email,
  
 +
<!--T:18-->
 
(string) password
 
(string) password
  
 +
<!--T:19-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 86: Строка 103:
  
  
== Профиль пользователя (profile) ==
+
== Профиль пользователя (profile) == <!--T:20-->
  
 +
<!--T:21-->
 
request:
 
request:
  
 +
<!--T:22-->
 
Request URL: [site]/api/profile/
 
Request URL: [site]/api/profile/
  
 +
<!--T:23-->
 
параметры запроса: (string) token
 
параметры запроса: (string) token
  
 +
<!--T:24-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 122: Строка 143:
 
</pre>
 
</pre>
  
= Контроллеры =
+
= Контроллеры = <!--T:25-->
  
== Список Контроллеров Пользователя (list) ==
+
== Список Контроллеров Пользователя (list) == <!--T:26-->
  
 +
<!--T:27-->
 
request:
 
request:
 
Request URL: [site]/api/ctrl/list/
 
Request URL: [site]/api/ctrl/list/
  
 +
<!--T:28-->
 
параметры запроса: (string) token
 
параметры запроса: (string) token
  
 +
<!--T:29-->
 
Пример запроса:
 
Пример запроса:
 
   
 
   
Строка 139: Строка 163:
 
</pre>
 
</pre>
  
 +
<!--T:30-->
 
response:
 
response:
  
 +
<!--T:31-->
 
параметры ответа: (array)  
 
параметры ответа: (array)  
  
 +
<!--T:32-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 169: Строка 196:
  
  
== Информация о Контроллере (info) ==
+
== Информация о Контроллере (info) == <!--T:33-->
  
 +
<!--T:34-->
 
request:
 
request:
 
Request URL: [site]/api/ctrl/info/
 
Request URL: [site]/api/ctrl/info/
  
 +
<!--T:35-->
 
параметры запроса: (int) controller_id , (string) token
 
параметры запроса: (int) controller_id , (string) token
  
 +
<!--T:36-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 184: Строка 214:
 
</pre>
 
</pre>
  
 +
<!--T:37-->
 
response:
 
response:
  
 +
<!--T:38-->
 
параметры ответа: (object)
 
параметры ответа: (object)
  
 +
<!--T:39-->
 
Пример ответа:  
 
Пример ответа:  
  
 +
<!--T:40-->
 
<pre>
 
<pre>
 
{
 
{
Строка 203: Строка 237:
 
</pre>
 
</pre>
  
== Постановка/снятие Контроллера на охрану / с охраны  (armed) ==
+
== Постановка/снятие Контроллера на охрану / с охраны  (armed) == <!--T:41-->
  
 +
<!--T:42-->
 
request:
 
request:
  
 +
<!--T:43-->
 
Request URL: [site]/api/ctrl/armed/
 
Request URL: [site]/api/ctrl/armed/
  
 +
<!--T:44-->
 
параметры запроса: (int) controller_id , (string) token
 
параметры запроса: (int) controller_id , (string) token
 
пример:  
 
пример:  
  
 +
<!--T:45-->
 
<pre>
 
<pre>
 
{
 
{
Строка 229: Строка 267:
  
  
== Добавление Контроллера (add) ==
+
== Добавление Контроллера (add) == <!--T:46-->
  
 +
<!--T:47-->
 
request:
 
request:
  
 +
<!--T:48-->
 
Request URL: [site]/api/ctrl/add
 
Request URL: [site]/api/ctrl/add
  
 +
<!--T:49-->
 
параметры запроса: (string) token
 
параметры запроса: (string) token
  
 +
<!--T:50-->
 
Пример:  
 
Пример:  
 
<pre>
 
<pre>
Строка 253: Строка 295:
 
После ввода пин-кода необходимо обновить список Контроллеров (/api/ctrl/list/)
 
После ввода пин-кода необходимо обновить список Контроллеров (/api/ctrl/list/)
  
== Обновление списка устройств и действий на Контроллере (update) ==
+
== Обновление списка устройств и действий на Контроллере (update) == <!--T:51-->
  
=== Этап 1 - обновляем список IDS устройств на Контроллере ===
+
=== Этап 1 - обновляем список IDS устройств на Контроллере === <!--T:52-->
 
request:
 
request:
  
 +
<!--T:53-->
 
Request URL: [site]/api/ctrl/update/
 
Request URL: [site]/api/ctrl/update/
 
параметры запроса: (int) controller_id , (string) token
 
параметры запроса: (int) controller_id , (string) token
Строка 276: Строка 319:
 
</pre>
 
</pre>
  
=== Этап 2 - обновляем информацию о каждом устройстве ===
+
=== Этап 2 - обновляем информацию о каждом устройстве === <!--T:54-->
  
 +
<!--T:55-->
 
request:
 
request:
 
Request URL: [site]/api/ctrl/update-devices/
 
Request URL: [site]/api/ctrl/update-devices/
  
 +
<!--T:56-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:57-->
 
(int) controller_id,
 
(int) controller_id,
 
(string) token
 
(string) token
  
 +
<!--T:58-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 294: Строка 341:
 
</pre>
 
</pre>
  
 +
<!--T:59-->
 
response:
 
response:
  
 +
<!--T:60-->
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:61-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 307: Строка 357:
  
  
== Удаление Контроллера (delete) ==
+
== Удаление Контроллера (delete) == <!--T:62-->
  
 +
<!--T:63-->
 
Request URL: [site]/api/ctrl/delete
 
Request URL: [site]/api/ctrl/delete
  
 +
<!--T:64-->
 
Параметры запроса:  
 
Параметры запроса:  
  
 +
<!--T:65-->
 
Пример запроса:
 
Пример запроса:
 
   
 
   
Строка 322: Строка 375:
 
</pre>
 
</pre>
  
 +
<!--T:66-->
 
response:
 
response:
 
параметры ответа:  
 
параметры ответа:  
Строка 332: Строка 386:
 
</pre>
 
</pre>
  
== Обновление статуса контроллера (update-status) ==
+
== Обновление статуса контроллера (update-status) == <!--T:67-->
  
 +
<!--T:68-->
 
request:
 
request:
  
 +
<!--T:69-->
 
Request URL: [site]/api/ ctrl/update-status/
 
Request URL: [site]/api/ ctrl/update-status/
  
 +
<!--T:70-->
 
Параметры запроса:
 
Параметры запроса:
  
 +
<!--T:71-->
 
(string) token,
 
(string) token,
  
 +
<!--T:72-->
 
(int) controller_id
 
(int) controller_id
  
 +
<!--T:73-->
 
Пример запроса:
 
Пример запроса:
 
<pre>
 
<pre>
Строка 352: Строка 412:
 
</pre>
 
</pre>
  
 +
<!--T:74-->
 
response:
 
response:
  
 +
<!--T:75-->
 
параметры ответа:
 
параметры ответа:
  
 +
<!--T:76-->
 
Пример ответа:
 
Пример ответа:
 
<pre>
 
<pre>
Строка 366: Строка 429:
 
</pre>
 
</pre>
  
== Получение актуального статуса Контроллера (get-status) ==  
+
== Получение актуального статуса Контроллера (get-status) == <!--T:77-->
 
request:
 
request:
  
 +
<!--T:78-->
 
Request URL: [site]/api/ ctrl/get-status/
 
Request URL: [site]/api/ ctrl/get-status/
  
 +
<!--T:79-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:80-->
 
(string) token,
 
(string) token,
  
 +
<!--T:81-->
 
(int) controller_id
 
(int) controller_id
  
 +
<!--T:82-->
 
Пример запроса:
 
Пример запроса:
 
<pre>
 
<pre>
Строка 385: Строка 453:
 
</pre>
 
</pre>
  
 +
<!--T:83-->
 
response:
 
response:
  
 +
<!--T:84-->
 
параметры ответа:
 
параметры ответа:
  
 +
<!--T:85-->
 
Пример ответа:
 
Пример ответа:
 
<pre>
 
<pre>
Строка 399: Строка 470:
 
</pre>
 
</pre>
  
 +
<!--T:86-->
 
Поле “status” может принимать следующие значения:
 
Поле “status” может принимать следующие значения:
 
• 0 – офлайн
 
• 0 – офлайн
  
 +
<!--T:87-->
 
• 1 – онлайн
 
• 1 – онлайн
  
 +
<!--T:88-->
 
• 2 – онлайн, после включения питания
 
• 2 – онлайн, после включения питания
  
==  Передача локального IP Контроллера (get-ip) ==
+
==  Передача локального IP Контроллера (get-ip) == <!--T:89-->
  
 +
<!--T:90-->
 
Request URL: [site]/api/ctrl/get-ip
 
Request URL: [site]/api/ctrl/get-ip
  
 +
<!--T:91-->
 
Request Params:
 
Request Params:
  
 +
<!--T:92-->
 
token (required): string(64);
 
token (required): string(64);
  
 +
<!--T:93-->
 
controller_id (required): int;
 
controller_id (required): int;
  
 +
<!--T:94-->
 
SUCCESS RESPONSE:  
 
SUCCESS RESPONSE:  
  
 +
<!--T:95-->
 
<pre>
 
<pre>
 
{
 
{
Строка 425: Строка 505:
 
</pre>
 
</pre>
  
== Установка подписки на Контроллере ==
+
== Установка подписки на Контроллере == <!--T:96-->
 
in/subscription/set
 
in/subscription/set
  
 +
<!--T:97-->
 
Request URL: [site]/in/subscription/set”
 
Request URL: [site]/in/subscription/set”
 
<pre>
 
<pre>
Строка 437: Строка 518:
 
</pre>
 
</pre>
  
==  Просмотр статуса подписки (get-subscribe-status) ==
+
==  Просмотр статуса подписки (get-subscribe-status) == <!--T:98-->
  
 +
<!--T:99-->
 
Request URL: [site]/api/ctrl/get-subscribe-status
 
Request URL: [site]/api/ctrl/get-subscribe-status
  
 +
<!--T:100-->
 
params:
 
params:
  
 +
<!--T:101-->
 
token (required): string(64)
 
token (required): string(64)
  
 +
<!--T:102-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:103-->
 
response:
 
response:
  
 +
<!--T:104-->
 
{data:{id: 1, controller_id: 40, user_id: 424, remain_time: 100, request_time: 1355314332, response_time: 1355315332, success: 0}, error: ''}
 
{data:{id: 1, controller_id: 40, user_id: 424, remain_time: 100, request_time: 1355314332, response_time: 1355315332, success: 0}, error: ''}
  
  
==  Активация/продление/покупка подписки (set-subscribe) ==
+
==  Активация/продление/покупка подписки (set-subscribe) == <!--T:105-->
  
  
 +
<!--T:106-->
 
Request URL: [site]/api/ctrl/set-subscribe
 
Request URL: [site]/api/ctrl/set-subscribe
  
 +
<!--T:107-->
 
params:
 
params:
  
 +
<!--T:108-->
 
token (required): string(64)
 
token (required): string(64)
  
 +
<!--T:109-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:110-->
 
response:
 
response:
 
<pre>
 
<pre>
Строка 480: Строка 572:
  
  
==  Метод получения списка телефонов (get-phones) ==
+
==  Метод получения списка телефонов (get-phones) == <!--T:111-->
  
 +
<!--T:112-->
 
Request URL: [site]/api/ctrl/get-phones
 
Request URL: [site]/api/ctrl/get-phones
  
 +
<!--T:113-->
 
Params:
 
Params:
  
 +
<!--T:114-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:115-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:116-->
 
type (optional): string,
 
type (optional): string,
 
range ['recipient', 'authorized', 'all'], default 'all'
 
range ['recipient', 'authorized', 'all'], default 'all'
  
 +
<!--T:117-->
 
Response:
 
Response:
  
 +
<!--T:118-->
 
<pre>
 
<pre>
 
{
 
{
Строка 507: Строка 606:
  
  
==  Редактирование телефона (edit-phone) ==
+
==  Редактирование телефона (edit-phone) == <!--T:119-->
  
 +
<!--T:120-->
 
Request URL: [site]/api/ctrl/edit-phone
 
Request URL: [site]/api/ctrl/edit-phone
  
 +
<!--T:121-->
 
Params:
 
Params:
  
 +
<!--T:122-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:123-->
 
phone_id (required): int
 
phone_id (required): int
  
 +
<!--T:124-->
 
is_recipient (optional): int
 
is_recipient (optional): int
  
 +
<!--T:125-->
 
is_authorized (optional): int
 
is_authorized (optional): int
  
 +
<!--T:126-->
 
phone (optional): string
 
phone (optional): string
  
 +
<!--T:127-->
 
Response:  
 
Response:  
 
<pre>
 
<pre>
Строка 538: Строка 645:
  
  
==  Удаление телефона (delete-phone) ==
+
==  Удаление телефона (delete-phone) == <!--T:128-->
  
 +
<!--T:129-->
 
Request URL: [site]/api/ctrl/delete-phone
 
Request URL: [site]/api/ctrl/delete-phone
  
 +
<!--T:130-->
 
Params:
 
Params:
  
 +
<!--T:131-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:132-->
 
phone_id (required): int
 
phone_id (required): int
  
 +
<!--T:133-->
 
Response:  
 
Response:  
 
<pre>
 
<pre>
Строка 556: Строка 668:
 
</pre>
 
</pre>
  
== Добавление телефона (add-phone) ==
+
== Добавление телефона (add-phone) == <!--T:134-->
  
 +
<!--T:135-->
 
Request URL: [site]/api/ctrl/add-phone
 
Request URL: [site]/api/ctrl/add-phone
  
 +
<!--T:136-->
 
Params:
 
Params:
  
 +
<!--T:137-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:138-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:139-->
 
phone (required): string
 
phone (required): string
  
 +
<!--T:140-->
 
is_recipient (optional): int
 
is_recipient (optional): int
  
 +
<!--T:141-->
 
is_authorized (optional): int
 
is_authorized (optional): int
  
 +
<!--T:142-->
 
Response:  
 
Response:  
  
 +
<!--T:143-->
 
<pre>
 
<pre>
 
{
 
{
Строка 587: Строка 708:
 
</pre>
 
</pre>
  
= Устройства =
+
= Устройства = <!--T:144-->
  
== Получение списка устройств пользователя (list) ==
+
== Получение списка устройств пользователя (list) == <!--T:145-->
  
 +
<!--T:146-->
 
request:
 
request:
  
 +
<!--T:147-->
 
Request URL: [site]/api/device/list
 
Request URL: [site]/api/device/list
  
 +
<!--T:148-->
 
параметры запроса: (int) controller_id , (string) token
 
параметры запроса: (int) controller_id , (string) token
  
 +
<!--T:149-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 605: Строка 730:
 
</pre>
 
</pre>
  
 +
<!--T:150-->
 
response:
 
response:
 
параметры ответа:
 
параметры ответа:
Строка 657: Строка 783:
  
  
== Информация об устройстве (info) ==
+
== Информация об устройстве (info) == <!--T:151-->
  
 +
<!--T:152-->
 
request:
 
request:
  
 +
<!--T:153-->
 
Request URL: [site]/api/device/info/
 
Request URL: [site]/api/device/info/
  
 +
<!--T:154-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:155-->
 
(int) controller_id,
 
(int) controller_id,
  
 +
<!--T:156-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:157-->
 
(string) token
 
(string) token
  
 +
<!--T:158-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 680: Строка 813:
 
</pre>
 
</pre>
  
 +
<!--T:159-->
 
response:
 
response:
  
 +
<!--T:160-->
 
параметры ответа:
 
параметры ответа:
 
   
 
   
Строка 727: Строка 862:
  
  
== Обновление информации об устройстве (update) ==
+
== Обновление информации об устройстве (update) == <!--T:161-->
  
 +
<!--T:162-->
 
request:
 
request:
  
 +
<!--T:163-->
 
Request URL: [site]/api/device/update/
 
Request URL: [site]/api/device/update/
  
 +
<!--T:164-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:165-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:166-->
 
(string) name,
 
(string) name,
  
 +
<!--T:167-->
 
(int) active,
 
(int) active,
  
 +
<!--T:168-->
 
(string) token,
 
(string) token,
  
 +
<!--T:169-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 754: Строка 897:
 
response:
 
response:
  
 +
<!--T:170-->
 
параметры ответа:
 
параметры ответа:
 
   
 
   
Строка 763: Строка 907:
 
</pre>
 
</pre>
  
== Удаление устройства (delete) ==
+
== Удаление устройства (delete) == <!--T:171-->
  
 +
<!--T:172-->
 
request:
 
request:
  
 +
<!--T:173-->
 
Request URL: [site]/api/device/delete/
 
Request URL: [site]/api/device/delete/
  
 +
<!--T:174-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:175-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:176-->
 
(string) token
 
(string) token
  
 +
<!--T:177-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 783: Строка 933:
 
</pre>
 
</pre>
  
 +
<!--T:178-->
 
response:
 
response:
  
 +
<!--T:179-->
 
Параметры ответа:  
 
Параметры ответа:  
  
 +
<!--T:180-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 792: Строка 945:
 
"resuls" : "Ok"
 
"resuls" : "Ok"
  
 +
<!--T:181-->
 
}
 
}
 
</pre>
 
</pre>
  
  
== Получение метеоданных (last) ==
+
== Получение метеоданных (last) == <!--T:182-->
  
 +
<!--T:183-->
 
request:
 
request:
 
Request URL: [site]/api/device/meteo-last/
 
Request URL: [site]/api/device/meteo-last/
  
 +
<!--T:184-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:185-->
 
(string) token,
 
(string) token,
  
 +
<!--T:186-->
 
(int) device_id
 
(int) device_id
  
 +
<!--T:187-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 816: Строка 975:
 
response:
 
response:
  
 +
<!--T:188-->
 
параметры ответа: (object)
 
параметры ответа: (object)
  
 +
<!--T:189-->
 
Пример ответа:  
 
Пример ответа:  
  
 +
<!--T:190-->
 
<pre>
 
<pre>
 
{
 
{
Строка 837: Строка 999:
 
</pre>
 
</pre>
  
== Получение метеоданных за период (period) ==
+
== Получение метеоданных за период (period) == <!--T:191-->
 
request:
 
request:
  
 +
<!--T:192-->
 
Request URL: [site]/api/device/meteo-period/
 
Request URL: [site]/api/device/meteo-period/
  
 +
<!--T:193-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:194-->
 
(string) token,
 
(string) token,
  
 +
<!--T:195-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:196-->
 
(int) period
 
(int) period
  
 +
<!--T:197-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 859: Строка 1027:
 
</pre>
 
</pre>
  
 +
<!--T:198-->
 
response:
 
response:
  
 +
<!--T:199-->
 
параметры ответа: (array to objects)
 
параметры ответа: (array to objects)
  
 +
<!--T:200-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 888: Строка 1059:
 
</pre>
 
</pre>
  
== Получение данных электропитания (last) ==
+
== Получение данных электропитания (last) == <!--T:201-->
 
   
 
   
 
request:
 
request:
 
Request URL: [site]/api/device/electro-last/
 
Request URL: [site]/api/device/electro-last/
  
 +
<!--T:202-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:203-->
 
(string) token,
 
(string) token,
  
 +
<!--T:204-->
 
(int) device_id
 
(int) device_id
  
 +
<!--T:205-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 907: Строка 1082:
 
</pre>
 
</pre>
  
 +
<!--T:206-->
 
response:
 
response:
  
 +
<!--T:207-->
 
параметры ответа: (object)
 
параметры ответа: (object)
  
 +
<!--T:208-->
 
Пример ответа:  
 
Пример ответа:  
  
 +
<!--T:209-->
 
<pre>
 
<pre>
 
{
 
{
Строка 933: Строка 1112:
 
</pre>  
 
</pre>  
  
== Получение данных электропитания за период (period) ==
+
== Получение данных электропитания за период (period) == <!--T:210-->
 
   
 
   
 
request:
 
request:
  
 +
<!--T:211-->
 
Request URL: [site]/api/device/electro-period/
 
Request URL: [site]/api/device/electro-period/
  
 +
<!--T:212-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:213-->
 
(string) token,
 
(string) token,
  
 +
<!--T:214-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:215-->
 
(int) period
 
(int) period
  
 +
<!--T:216-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 957: Строка 1142:
 
response:
 
response:
  
 +
<!--T:217-->
 
параметры ответа: (array to objects)
 
параметры ответа: (array to objects)
  
 +
<!--T:218-->
 
Пример ответа:
 
Пример ответа:
 
   
 
   
Строка 988: Строка 1175:
 
</pre>
 
</pre>
  
== Получение данных о сторонних устройствах (other-last) ==
+
== Получение данных о сторонних устройствах (other-last) == <!--T:219-->
  
 +
<!--T:220-->
 
Метод возвращает информацию о последнем обнаруженном стороннем устройстве.
 
Метод возвращает информацию о последнем обнаруженном стороннем устройстве.
 
   
 
   
 
request:
 
request:
  
 +
<!--T:221-->
 
Request URL: [site]/api/device/other-last/
 
Request URL: [site]/api/device/other-last/
  
 +
<!--T:222-->
 
Параметры запроса:
 
Параметры запроса:
  
 +
<!--T:223-->
 
(string) token,
 
(string) token,
  
 +
<!--T:224-->
 
(int) device_id
 
(int) device_id
  
 +
<!--T:225-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 1011: Строка 1204:
 
response:
 
response:
  
 +
<!--T:226-->
 
параметры ответа: (object)
 
параметры ответа: (object)
  
 +
<!--T:227-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1033: Строка 1228:
  
  
== Получение данных о сторонних устройствах за период (other-period) ==
+
== Получение данных о сторонних устройствах за период (other-period) == <!--T:228-->
 
request:
 
request:
  
 +
<!--T:229-->
 
Request URL: [site]/api/device/other-period/
 
Request URL: [site]/api/device/other-period/
  
 +
<!--T:230-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:231-->
 
(string) token,
 
(string) token,
  
 +
<!--T:232-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:233-->
 
(int) period
 
(int) period
  
 +
<!--T:234-->
 
Пример запроса:  
 
Пример запроса:  
 
{
 
{
Строка 1054: Строка 1255:
 
response:
 
response:
  
 +
<!--T:235-->
 
параметры ответа: (array to objects)
 
параметры ответа: (array to objects)
  
 +
<!--T:236-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1080: Строка 1283:
 
</pre>
 
</pre>
  
= Wizard добавления устройств  =
+
= Wizard добавления устройств  = <!--T:237-->
  
  
== Датчик открытия двери (create-door-open-sensor) ==
+
== Датчик открытия двери (create-door-open-sensor) == <!--T:238-->
  
 +
<!--T:239-->
 
URL:  [site]/api/wizard/create-door-open-sensor
 
URL:  [site]/api/wizard/create-door-open-sensor
  
 +
<!--T:240-->
 
Params:
 
Params:
 
controller_id (required): int
 
controller_id (required): int
Строка 1095: Строка 1300:
 
code_low_battery (optional): string, 64 //Название кода садящейся батареи
 
code_low_battery (optional): string, 64 //Название кода садящейся батареи
  
 +
<!--T:241-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1105: Строка 1311:
 
</pre>
 
</pre>
  
 +
<!--T:242-->
 
После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
 
После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
  
  
==  Датчик затопления (create-flood-sensor) ==
+
==  Датчик затопления (create-flood-sensor) == <!--T:243-->
  
 +
<!--T:244-->
 
Request URL: [site]/api/wizard/create-flood-sensor
 
Request URL: [site]/api/wizard/create-flood-sensor
  
 +
<!--T:245-->
 
Params:
 
Params:
  
 +
<!--T:246-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:247-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:248-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
 
code_alarm (optional): string, 64 //Название кода оповещения
 
code_alarm (optional): string, 64 //Название кода оповещения
  
 +
<!--T:249-->
 
code_tamper (optional): string, 64 //Название кода вмешательства
 
code_tamper (optional): string, 64 //Название кода вмешательства
  
 +
<!--T:250-->
 
code_low_battery (optional): string, 64 //Название кода садящейся батареи
 
code_low_battery (optional): string, 64 //Название кода садящейся батареи
  
 +
<!--T:251-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1138: Строка 1353:
  
  
== Пульт,4 кнопки (create-console) ==
+
== Пульт,4 кнопки (create-console) == <!--T:252-->
  
 +
<!--T:253-->
 
Request URL: [site]/api/wizard/create-console
 
Request URL: [site]/api/wizard/create-console
  
 +
<!--T:254-->
 
Params:
 
Params:
  
 +
<!--T:255-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:256-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:257-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
  
 +
<!--T:258-->
 
code_lock (optional): string, 64 //Название кода блокировки
 
code_lock (optional): string, 64 //Название кода блокировки
  
 +
<!--T:259-->
 
code_unlock (optional): string, 64 //Название кода разблокировки
 
code_unlock (optional): string, 64 //Название кода разблокировки
  
 +
<!--T:260-->
 
code_s (optional): string, 64 //Название кода s
 
code_s (optional): string, 64 //Название кода s
  
 +
<!--T:261-->
 
code_alarm (optional): string, 64 //Название кода оповещения
 
code_alarm (optional): string, 64 //Название кода оповещения
  
 +
<!--T:262-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1171: Строка 1396:
  
  
== Сирена (create-siren) ==
+
== Сирена (create-siren) == <!--T:263-->
  
 +
<!--T:264-->
 
Request URL: [site]/api/wizard/create-siren
 
Request URL: [site]/api/wizard/create-siren
  
 +
<!--T:265-->
 
Params:
 
Params:
  
 +
<!--T:266-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:267-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:268-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
  
 +
<!--T:269-->
 
code_on (optional): string, 64 //Название кода включения
 
code_on (optional): string, 64 //Название кода включения
  
 +
<!--T:270-->
 
code_off (optional): string, 64 //Название кода выключения
 
code_off (optional): string, 64 //Название кода выключения
  
 +
<!--T:271-->
 
code_blank (optional): string, 64 //Название кода blank
 
code_blank (optional): string, 64 //Название кода blank
  
 +
<!--T:272-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1202: Строка 1436:
  
  
== Метеостанция: получение списка обнаруженных метеостанций за последние 10 минут (get-meteos) ==
+
== Метеостанция: получение списка обнаруженных метеостанций за последние 10 минут (get-meteos) == <!--T:273-->
 
Request URL: [site]/api/wizard/get-meteos
 
Request URL: [site]/api/wizard/get-meteos
  
 +
<!--T:274-->
 
Params:
 
Params:
  
 +
<!--T:275-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:276-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:277-->
 
RESPONSE:
 
RESPONSE:
 
<pre>
 
<pre>
Строка 1219: Строка 1457:
 
</pre>
 
</pre>
  
== Метеостанция: добавление (create-meteo) ==
+
== Метеостанция: добавление (create-meteo) == <!--T:278-->
  
 +
<!--T:279-->
 
Request URL: [site][site]/api/wizard/create-meteo
 
Request URL: [site][site]/api/wizard/create-meteo
  
 +
<!--T:280-->
 
Params:
 
Params:
  
 +
<!--T:281-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:282-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:283-->
 
meteo_num (required): int //Получается в списке выше
 
meteo_num (required): int //Получается в списке выше
  
 +
<!--T:284-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
  
 +
<!--T:285-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1245: Строка 1490:
  
  
== Водопроводный кран ==
+
== Водопроводный кран == <!--T:286-->
  
 +
<!--T:287-->
 
Порядок добавления крана:
 
Порядок добавления крана:
 
1) Сгенерировать коды
 
1) Сгенерировать коды
  
 +
<!--T:288-->
 
2) Зажать на кране кнопку, пока кран не мигнёт трижды
 
2) Зажать на кране кнопку, пока кран не мигнёт трижды
  
 +
<!--T:289-->
 
3) Отправить один код
 
3) Отправить один код
  
 +
<!--T:290-->
 
4) Нажать на кране кнопку однократно
 
4) Нажать на кране кнопку однократно
  
 +
<!--T:291-->
 
5) Зажать на кране кнопку, пока не мигнёт 4 раза
 
5) Зажать на кране кнопку, пока не мигнёт 4 раза
  
 +
<!--T:292-->
 
6) Отправить второй код из сгенерированных
 
6) Отправить второй код из сгенерированных
  
 +
<!--T:293-->
 
7) Нажать на кране кнопку однократно
 
7) Нажать на кране кнопку однократно
  
 +
<!--T:294-->
 
8) Отправить запрос на создание крана.
 
8) Отправить запрос на создание крана.
  
  
=== Генерация кодов ===
+
=== Генерация кодов === <!--T:295-->
  
 +
<!--T:296-->
 
Request URL: [site]/api/wizard/create-codes
 
Request URL: [site]/api/wizard/create-codes
  
 +
<!--T:297-->
 
Params:
 
Params:
  
 +
<!--T:298-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:299-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:300-->
 
Response:  
 
Response:  
 
<pre>
 
<pre>
Строка 1285: Строка 1543:
  
  
=== Выполнение кода ===
+
=== Выполнение кода === <!--T:301-->
  
 +
<!--T:302-->
 
Request URL: [site]/api/wizard/execute-code
 
Request URL: [site]/api/wizard/execute-code
  
 +
<!--T:303-->
 
Params:
 
Params:
  
 +
<!--T:304-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:305-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:306-->
 
code (required): int // Берется из сгенерированных
 
code (required): int // Берется из сгенерированных
  
 +
<!--T:307-->
 
Response:
 
Response:
 
<pre>
 
<pre>
Строка 1307: Строка 1571:
 
</pre>
 
</pre>
  
=== Добавление крана ===
+
=== Добавление крана === <!--T:308-->
  
 +
<!--T:309-->
 
Request URL: [site]/api/wizard/create-crane-by-codes
 
Request URL: [site]/api/wizard/create-crane-by-codes
  
 +
<!--T:310-->
 
Params:
 
Params:
  
 +
<!--T:311-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:312-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:313-->
 
code_1 (required): int
 
code_1 (required): int
  
 +
<!--T:314-->
 
code_2 (required): int
 
code_2 (required): int
  
 +
<!--T:315-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
  
 +
<!--T:316-->
 
code_open (optional): string, 64 //Название кода открытия
 
code_open (optional): string, 64 //Название кода открытия
  
 +
<!--T:317-->
 
code_close (optional): string, 64 //Название кода закрытия
 
code_close (optional): string, 64 //Название кода закрытия
  
 +
<!--T:318-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1335: Строка 1609:
 
</pre>
 
</pre>
  
== Добавление розетки ==
+
== Добавление розетки == <!--T:319-->
  
 +
<!--T:320-->
 
порядок добаления розетки следующий:
 
порядок добаления розетки следующий:
  
 +
<!--T:321-->
 
1) Сгенерировать коды
 
1) Сгенерировать коды
  
 +
<!--T:322-->
 
2) Зажать на розетке кнопку, пока она не начнет мигать
 
2) Зажать на розетке кнопку, пока она не начнет мигать
  
 +
<!--T:323-->
 
3) Отправить один код
 
3) Отправить один код
  
 +
<!--T:324-->
 
4) Зажать на розетке кнопку, пока она не начнет мигать
 
4) Зажать на розетке кнопку, пока она не начнет мигать
  
 +
<!--T:325-->
 
5) Отправить второй код из сгенерированых
 
5) Отправить второй код из сгенерированых
  
 +
<!--T:326-->
 
6) Отправить запрос на создание розетки
 
6) Отправить запрос на создание розетки
  
  
=== Генерация кодов (create-codes) ===
+
=== Генерация кодов (create-codes) === <!--T:327-->
  
 +
<!--T:328-->
 
Request URL: [site]/api/wizard/create-codes
 
Request URL: [site]/api/wizard/create-codes
  
 +
<!--T:329-->
 
Params:
 
Params:
  
 +
<!--T:330-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:331-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:332-->
 
socket (required): любое значение.
 
socket (required): любое значение.
  
 +
<!--T:333-->
 
Response:
 
Response:
 
<pre>
 
<pre>
Строка 1375: Строка 1662:
  
  
=== Выполнение кода  (execute-code) ===
+
=== Выполнение кода  (execute-code) === <!--T:334-->
  
 +
<!--T:335-->
 
Request URL: [site]/api/wizard/execute-code
 
Request URL: [site]/api/wizard/execute-code
  
 +
<!--T:336-->
 
Params:
 
Params:
  
 +
<!--T:337-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:338-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:339-->
 
code (required): int // Берется из сгенерированных
 
code (required): int // Берется из сгенерированных
  
 +
<!--T:340-->
 
Response  
 
Response  
 
<pre>
 
<pre>
Строка 1396: Строка 1689:
  
  
=== Добавление розетки (create-socket) ===
+
=== Добавление розетки (create-socket) === <!--T:341-->
  
 +
<!--T:342-->
 
Request URL: [site]/api/wizard/create-socket
 
Request URL: [site]/api/wizard/create-socket
  
 +
<!--T:343-->
 
Params:
 
Params:
  
 +
<!--T:344-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:345-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:346-->
 
code_1 (required): int
 
code_1 (required): int
  
 +
<!--T:347-->
 
code_2 (required): int
 
code_2 (required): int
  
 +
<!--T:348-->
 
device_name (optional): string, 256
 
device_name (optional): string, 256
  
 +
<!--T:349-->
 
code_off (optional): string, 64 //Название кода открытия
 
code_off (optional): string, 64 //Название кода открытия
  
 +
<!--T:350-->
 
code_on (optional): string, 64 //Название кода закрытия
 
code_on (optional): string, 64 //Название кода закрытия
  
 +
<!--T:351-->
 
RESPONSE:  
 
RESPONSE:  
 
<pre>
 
<pre>
Строка 1424: Строка 1727:
 
</pre>
 
</pre>
  
= Сценарии =
+
= Сценарии = <!--T:352-->
  
== Список сценариев (list) ==
+
== Список сценариев (list) == <!--T:353-->
  
 +
<!--T:354-->
 
request:
 
request:
 
Request URL: [site]/api/scheduler/list/
 
Request URL: [site]/api/scheduler/list/
  
 +
<!--T:355-->
 
параметры запроса: (string) token
 
параметры запроса: (string) token
  
 +
<!--T:356-->
 
Пример запроса:
 
Пример запроса:
 
   
 
   
Строка 1441: Строка 1747:
 
</pre>
 
</pre>
  
 +
<!--T:357-->
 
response:
 
response:
  
 +
<!--T:358-->
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:359-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1497: Строка 1806:
 
}
 
}
  
 +
<!--T:360-->
 
</pre>
 
</pre>
  
  
== Обновление сценариев (update) ==
+
== Обновление сценариев (update) == <!--T:361-->
  
 +
<!--T:362-->
 
Запрос осуществляется в 2 этапа: на первом этапе происходит при запросе на обновление Контроллера (см. "Обновление Контроллера");
 
Запрос осуществляется в 2 этапа: на первом этапе происходит при запросе на обновление Контроллера (см. "Обновление Контроллера");
 
на втором этапе обновляется информация о каждом действии.
 
на втором этапе обновляется информация о каждом действии.
  
 +
<!--T:363-->
 
request:
 
request:
 
Request URL: [site]/api/scheduler/update/
 
Request URL: [site]/api/scheduler/update/
  
 +
<!--T:364-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:365-->
 
(int) controller_id,
 
(int) controller_id,
  
 +
<!--T:366-->
 
(string) token
 
(string) token
  
 +
<!--T:367-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 1522: Строка 1838:
 
</pre>
 
</pre>
  
 +
<!--T:368-->
 
response:
 
response:
  
 +
<!--T:369-->
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:370-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1535: Строка 1854:
  
  
== Информация о сценарии (info) ==
+
== Информация о сценарии (info) == <!--T:371-->
  
 +
<!--T:372-->
 
request:
 
request:
 
Request URL: [site]/api/scheduler/info/
 
Request URL: [site]/api/scheduler/info/
  
 +
<!--T:373-->
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:374-->
 
(int) scheduler_id,
 
(int) scheduler_id,
  
 +
<!--T:375-->
 
(string) token
 
(string) token
  
 +
<!--T:376-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1555: Строка 1879:
 
response:
 
response:
  
 +
<!--T:377-->
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:378-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1605: Строка 1931:
  
  
= Логи пользователя (logs) =
+
= Логи пользователя (logs) = <!--T:379-->
 
request:
 
request:
  
 +
<!--T:380-->
 
Request URL: [site]/api/profile/logs/
 
Request URL: [site]/api/profile/logs/
  
 +
<!--T:381-->
 
параметры запроса: (string) token
 
параметры запроса: (string) token
  
 +
<!--T:382-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 1630: Строка 1959:
  
  
= Коды =
+
= Коды = <!--T:383-->
  
== Получение информации о коде (info) ==
+
== Получение информации о коде (info) == <!--T:384-->
  
 +
<!--T:385-->
 
request:
 
request:
  
 +
<!--T:386-->
 
Request URL: [site]/api/property/info/
 
Request URL: [site]/api/property/info/
  
 +
<!--T:387-->
 
параметры запроса:
 
параметры запроса:
 
(int) controller_id,
 
(int) controller_id,
  
 +
<!--T:388-->
 
(int) device_id,
 
(int) device_id,
  
 +
<!--T:389-->
 
(int) code_id,
 
(int) code_id,
  
 +
<!--T:390-->
 
(string) token
 
(string) token
  
 +
<!--T:391-->
 
Пример запроса:  
 
Пример запроса:  
 
<pre>
 
<pre>
Строка 1655: Строка 1991:
 
"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 
"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
  
 +
<!--T:392-->
 
}
 
}
 
</pre>
 
</pre>
  
 +
<!--T:393-->
 
response:
 
response:
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:394-->
 
Пример ответа:  
 
Пример ответа:  
 
<pre>
 
<pre>
Строка 1684: Строка 2023:
  
  
== Изменение имени кода (update-code-name) ==
+
== Изменение имени кода (update-code-name) == <!--T:395-->
  
 +
<!--T:396-->
 
Request URL: [site]/api/device/update-code-name
 
Request URL: [site]/api/device/update-code-name
  
 +
<!--T:397-->
 
Request Params:
 
Request Params:
  
 +
<!--T:398-->
 
token (required): string(64)
 
token (required): string(64)
  
 +
<!--T:399-->
 
code_id (required): int
 
code_id (required): int
  
 +
<!--T:400-->
 
name (optional): string(255)
 
name (optional): string(255)
  
 +
<!--T:401-->
 
SUCCESS RESPONSE:
 
SUCCESS RESPONSE:
 
<pre>
 
<pre>
Строка 1706: Строка 2051:
 
</pre>
 
</pre>
  
==  Получение кодов по типу сигнала (get-codes-by-subtype) ==
+
==  Получение кодов по типу сигнала (get-codes-by-subtype) == <!--T:402-->
  
 +
<!--T:403-->
 
Request URL: [site]/api/device/get-codes-by-subtype
 
Request URL: [site]/api/device/get-codes-by-subtype
  
 +
<!--T:404-->
 
Request Params:
 
Request Params:
  
 +
<!--T:405-->
 
token (required): string(64)
 
token (required): string(64)
  
 +
<!--T:406-->
 
device_subtype_id (optional): int, default 0.
 
device_subtype_id (optional): int, default 0.
  
==  Получение списка кодов (get-codes) ==
+
==  Получение списка кодов (get-codes) == <!--T:407-->
  
 +
<!--T:408-->
 
Request URL: [site]/api/device/get-codes
 
Request URL: [site]/api/device/get-codes
  
 +
<!--T:409-->
 
PARAMS:
 
PARAMS:
 
token (required): string 64
 
token (required): string 64
  
 +
<!--T:410-->
 
controller_id (required): int
 
controller_id (required): int
  
 +
<!--T:411-->
 
SUCCESS RESPONSE:
 
SUCCESS RESPONSE:
 
<pre>
 
<pre>
Строка 1777: Строка 2130:
 
date_create: '2018-04-13 18:29:11"
 
date_create: '2018-04-13 18:29:11"
  
}
+
<!--T:412-->
 +
}
 
},  
 
},  
  
{
+
<!--T:413-->
 +
{
 
devices: [
 
devices: [
 
{
 
{
Строка 1828: Строка 2183:
 
date_create: '2018-04-13 18:29:11"
 
date_create: '2018-04-13 18:29:11"
  
}
+
<!--T:414-->
 +
}
 
},  
 
},  
 
},
 
},
Строка 1835: Строка 2191:
 
</pre>
 
</pre>
  
== Добавление кода к устройству (set-code-to-device) ==
+
== Добавление кода к устройству (set-code-to-device) == <!--T:415-->
  
 +
<!--T:416-->
 
Request URL: [site]/api/device/set-code-to-device
 
Request URL: [site]/api/device/set-code-to-device
  
 +
<!--T:417-->
 
PARAMS:
 
PARAMS:
  
 +
<!--T:418-->
 
token (required): string 64
 
token (required): string 64
  
 +
<!--T:419-->
 
code_id (required): int
 
code_id (required): int
  
 +
<!--T:420-->
 
device_id (required): int
 
device_id (required): int
  
 +
<!--T:421-->
 
name (optional): string 256
 
name (optional): string 256
  
 +
<!--T:422-->
 
SUCCESS RESPONSE:
 
SUCCESS RESPONSE:
 
<pre>
 
<pre>
Строка 1866: Строка 2229:
 
</pre>
 
</pre>
  
== Удаление кода (remove-code) ==
+
== Удаление кода (remove-code) == <!--T:423-->
  
 +
<!--T:424-->
 
Request URL: [site]/api/device/remove-code
 
Request URL: [site]/api/device/remove-code
 
PARAMS:
 
PARAMS:
  
 +
<!--T:425-->
 
token (required): string 64
 
token (required): string 64
  
 +
<!--T:426-->
 
code_id (required): int
 
code_id (required): int
  
 +
<!--T:427-->
 
SUCCESS RESPONSE:
 
SUCCESS RESPONSE:
 
<pre>
 
<pre>
Строка 1885: Строка 2252:
 
</pre>
 
</pre>
  
= События =
+
= События = <!--T:428-->
  
== Нажатие кнопки на устройстве (event) ==
+
== Нажатие кнопки на устройстве (event) == <!--T:429-->
  
 +
<!--T:430-->
 
request:
 
request:
  
 +
<!--T:431-->
 
Request URL: [site]/api/device/event/
 
Request URL: [site]/api/device/event/
 
параметры запроса:
 
параметры запроса:
  
 +
<!--T:432-->
 
(string) controller_name,
 
(string) controller_name,
  
 +
<!--T:433-->
 
(int) device_external_id,
 
(int) device_external_id,
  
 +
<!--T:434-->
 
(int) cod_external_id,
 
(int) cod_external_id,
  
 +
<!--T:435-->
 
(string) token,
 
(string) token,
  
 +
<!--T:436-->
 
(int) device_type
 
(int) device_type
  
 +
<!--T:437-->
 
Пример запроса:  
 
Пример запроса:  
  
 +
<!--T:438-->
 
<pre>
 
<pre>
 
{
 
{
Строка 1916: Строка 2292:
 
</pre>
 
</pre>
  
 +
<!--T:439-->
 
так как MQTT  односторонний - ответа быть не может. Может быть возвращён ответ, что запрос отправлен:
 
так как MQTT  односторонний - ответа быть не может. Может быть возвращён ответ, что запрос отправлен:
 
response:
 
response:
  
 +
<!--T:440-->
 
параметры ответа:  
 
параметры ответа:  
  
 +
<!--T:441-->
 
Пример ответа:  
 
Пример ответа:  
  
 +
<!--T:442-->
 
<pre>
 
<pre>
 
{
 
{
Строка 1929: Строка 2309:
 
</pre>
 
</pre>
  
= Места =
+
= Места = <!--T:443-->
  
== Получение списка мест (places-list) ==
+
== Получение списка мест (places-list) == <!--T:444-->
  
 +
<!--T:445-->
 
Request URL: [site]/api/places/places-list  
 
Request URL: [site]/api/places/places-list  
  
 +
<!--T:446-->
 
Request params:
 
Request params:
  
 +
<!--T:447-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:448-->
 
Response:  
 
Response:  
 
<pre>
 
<pre>
Строка 1950: Строка 2334:
  
  
== Создание места (create) ==
+
== Создание места (create) == <!--T:449-->
  
  
 +
<!--T:450-->
 
Request URL: [site]/api/places/create
 
Request URL: [site]/api/places/create
  
 +
<!--T:451-->
 
Request params:
 
Request params:
  
 +
<!--T:452-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:453-->
 
root (optional): int, default 1
 
root (optional): int, default 1
  
 +
<!--T:454-->
 
lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
 
lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
  
 +
<!--T:455-->
 
rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
 
rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
  
 +
<!--T:456-->
 
lvl (optional): int, default 0
 
lvl (optional): int, default 0
  
 +
<!--T:457-->
 
name (optional): string, 64, default 'Simple name'
 
name (optional): string, 64, default 'Simple name'
  
 +
<!--T:458-->
 
icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
 
icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
  
 +
<!--T:459-->
 
color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
 
color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
  
 +
<!--T:460-->
 
active (optional): int, default 1
 
active (optional): int, default 1
  
 +
<!--T:461-->
 
selected (optional): int, default 0
 
selected (optional): int, default 0
  
 +
<!--T:462-->
 
disabled (optional): int, default 0
 
disabled (optional): int, default 0
  
 +
<!--T:463-->
 
readonly (optional): int, default 0
 
readonly (optional): int, default 0
  
 +
<!--T:464-->
 
visible (optional): int, default 1
 
visible (optional): int, default 1
  
 +
<!--T:465-->
 
collapsed (optional): int, default 0
 
collapsed (optional): int, default 0
  
 +
<!--T:466-->
 
movable_u (optional): int, default 1
 
movable_u (optional): int, default 1
  
 +
<!--T:467-->
 
movable_d (optional): int, default 1
 
movable_d (optional): int, default 1
  
 +
<!--T:468-->
 
movable_l (optional): int, default 1
 
movable_l (optional): int, default 1
  
 +
<!--T:469-->
 
movable_r (optional): int, default 1
 
movable_r (optional): int, default 1
  
 +
<!--T:470-->
 
removable (optional): int, default 1
 
removable (optional): int, default 1
  
 +
<!--T:471-->
 
removable_all (optional): int, default 0
 
removable_all (optional): int, default 0
  
 +
<!--T:472-->
 
inverse_text (optional): string, default 'black'
 
inverse_text (optional): string, default 'black'
  
  
 +
<!--T:473-->
 
Response:  
 
Response:  
 
<pre>
 
<pre>
Строка 2009: Строка 2417:
  
  
==  Редактирование места (edit) ==
+
==  Редактирование места (edit) == <!--T:474-->
  
 +
<!--T:475-->
 
Request URL: [site]/api/places/edit
 
Request URL: [site]/api/places/edit
  
 +
<!--T:476-->
 
Request params:
 
Request params:
  
 +
<!--T:477-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:478-->
 
place_id (required): int
 
place_id (required): int
  
 +
<!--T:479-->
 
root (optional): int, default 1
 
root (optional): int, default 1
  
 +
<!--T:480-->
 
lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
 
lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
  
 +
<!--T:481-->
 
rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
 
rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
  
 +
<!--T:482-->
 
lvl (optional): int, default 0
 
lvl (optional): int, default 0
  
 +
<!--T:483-->
 
name (optional): string, 64, default 'Simple name'
 
name (optional): string, 64, default 'Simple name'
  
 +
<!--T:484-->
 
icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
 
icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
  
 +
<!--T:485-->
 
color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
 
color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
  
 +
<!--T:486-->
 
active (optional): int, default 1
 
active (optional): int, default 1
  
 +
<!--T:487-->
 
selected (optional): int, default 0
 
selected (optional): int, default 0
  
 +
<!--T:488-->
 
disabled (optional): int, default 0
 
disabled (optional): int, default 0
  
 +
<!--T:489-->
 
readonly (optional): int, default 0
 
readonly (optional): int, default 0
  
 +
<!--T:490-->
 
visible (optional): int, default 1
 
visible (optional): int, default 1
  
 +
<!--T:491-->
 
collapsed (optional): int, default 0
 
collapsed (optional): int, default 0
  
 +
<!--T:492-->
 
movable_u (optional): int, default 1
 
movable_u (optional): int, default 1
  
 +
<!--T:493-->
 
movable_d (optional): int, default 1
 
movable_d (optional): int, default 1
  
 +
<!--T:494-->
 
movable_l (optional): int, default 1
 
movable_l (optional): int, default 1
  
 +
<!--T:495-->
 
movable_r (optional): int, default 1
 
movable_r (optional): int, default 1
  
 +
<!--T:496-->
 
removable (optional): int, default 1
 
removable (optional): int, default 1
  
 +
<!--T:497-->
 
removable_all (optional): int, default 0
 
removable_all (optional): int, default 0
  
 +
<!--T:498-->
 
inverse_text (optional): string, default 'black'
 
inverse_text (optional): string, default 'black'
  
  
 +
<!--T:499-->
 
Response:
 
Response:
 
<pre>
 
<pre>
Строка 2067: Строка 2500:
 
}
 
}
  
 +
<!--T:500-->
 
</pre>
 
</pre>
  
== Удаление места (delete) ==
+
== Удаление места (delete) == <!--T:501-->
  
 +
<!--T:502-->
 
Request URL: [site]/api/places/delete
 
Request URL: [site]/api/places/delete
  
 +
<!--T:503-->
 
Request params:
 
Request params:
  
 +
<!--T:504-->
 
token (required): string, 64
 
token (required): string, 64
  
 +
<!--T:505-->
 
place_id (required): int
 
place_id (required): int
  
 +
<!--T:506-->
 
Response:
 
Response:
 
<pre>
 
<pre>
Строка 2091: Строка 2530:
  
  
==  Активация подписки Ebus  ==
+
==  Активация подписки Ebus  == <!--T:507-->
  
  
 +
<!--T:508-->
 
Получение состояния подписки на Контроллере - “in/subscription/get”:
 
Получение состояния подписки на Контроллере - “in/subscription/get”:
  
 +
<!--T:509-->
 
<pre>
 
<pre>
 
{
 
{
Строка 2103: Строка 2544:
 
</pre>
 
</pre>
  
 +
<!--T:510-->
 
Ответ:
 
Ответ:
  
 +
<!--T:511-->
 
<pre>
 
<pre>
 
{
 
{
Строка 2113: Строка 2556:
 
</pre>
 
</pre>
  
 +
<!--T:512-->
 
Установка подписки на Контроллере - “in/subscription/set”:
 
Установка подписки на Контроллере - “in/subscription/set”:
  
 +
<!--T:513-->
 
<pre>
 
<pre>
 
{
 
{
Строка 2123: Строка 2568:
 
</pre>
 
</pre>
  
 +
<!--T:514-->
 
Ответ:
 
Ответ:
 
<pre>
 
<pre>
Строка 2131: Строка 2577:
 
</pre>
 
</pre>
  
 +
<!--T:515-->
 
Идентификаторы подписок:
 
Идентификаторы подписок:
 
SUBSCRIPTION_EBUS = 1
 
SUBSCRIPTION_EBUS = 1
  
 +
<!--T:516-->
 
Статус Контроллера
 
Статус Контроллера
  
 +
<!--T:517-->
 
Контроллер отправляет информацию о своем онлайн/оффлайн статусе в топик “out/status”.
 
Контроллер отправляет информацию о своем онлайн/оффлайн статусе в топик “out/status”.
  
 +
<!--T:518-->
 
Формат сообщения:
 
Формат сообщения:
 
<pre>
 
<pre>
Строка 2145: Строка 2595:
 
</pre>
 
</pre>
  
 +
<!--T:519-->
 
Поле “status” может принимать следующие значения:
 
Поле “status” может принимать следующие значения:
  
 +
<!--T:520-->
 
• "0" – оффлайн
 
• "0" – оффлайн
  
 +
<!--T:521-->
 
• "1" – онлайн
 
• "1" – онлайн
  
 +
<!--T:522-->
 
• "2" – онлайн, после включения питания
 
• "2" – онлайн, после включения питания
  
 +
<!--T:523-->
 
При получении сообщения со статусом "2", портал должен отправить Контроллеру информацию о пользовательских подписках, как это описано в разделе «Подписки».
 
При получении сообщения со статусом "2", портал должен отправить Контроллеру информацию о пользовательских подписках, как это описано в разделе «Подписки».
  
  
= Ошибки =
+
= Ошибки = <!--T:524-->
  
 +
<!--T:525-->
 
параметры ошибки:
 
параметры ошибки:
 
   
 
   
 
пример:  
 
пример:  
  
 +
<!--T:526-->
 
<pre>
 
<pre>
 
{
 
{

Версия 13:58, 28 марта 2019

Другие языки:
English • ‎русский • ‎українська • ‎中文(中国大陆)‎
  • API v01 *

API ( json )

URL https://quadrobit.com/

Содержание

Учётная запись

Авторизация (login)

request:

Request URL: [site]/api/login

параметры запроса:

(string) email,

(string) password

Пример запроса:

{
	"email":"aaaa@aaaa.aa",
	"password":"12345678"
}

response: параметры ответа: (object)

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

{
	"user_id":1,
	"username":"Ivan Pupkin",
	"email":"aaaa@aaa.aa",
	"phone": "423546546546",
	"sex":2, 		// пол 0 - не указан , 1 - женский  , 2 - мужской
	"country":219,  		// код страны в базе
	"active_configuration":"1",
	"refcode":"JHE-1GD-T8B-9HB",
	"status":10,       		// 0 - неактивен , 10 - активен
	"token":"1Cyuvr9DKMbB6aFQ-mLPLeGZXFLyuK8d",
	"expired":1502586831 // метка времени до которой активен token
}


Регистрация (registration)

request: Request URL: [site]/api/registration

параметры запроса:

(string) email,

(string) password

Пример запроса:

{
	"email":"aaaa@aaaa.aa",
	"password":"12345678"
}

response: параметры ответа: (object) пример:

{
    	"user_id": 43,
    	"username": "user_4383",
    	"email": "aaaa@aaa.aa",
    	"sex": null,
   	 "country": null,
   	 "active_configuration": null,
    	"refcode": "746-81O-0RJ-RJS",
    	"status": 10
}


Профиль пользователя (profile)

request:

Request URL: [site]/api/profile/

параметры запроса: (string) token

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response: параметры ответа: (object) пример:

{
	"user_id":1,
	"username":"Ivan Pupkin",
	"email":"aaaa@aaa.aa",
	"phone": "423546546546",
	"sex":2, 		// пол 0 - не указан , 1 - женский  , 2 - мужской
	"send_email": 1,
              "send_sms": 0,
               "role": 1,
               "lang": 2,
	"country":219,  		// код страны в базе
	"active_configuration":"1",
	"refcode":"JHE-1GD-T8B-9HB",
	"status":10,       		// 0 - неактивен , 10 - активен
	"token":"1Cyuvr9DKMbB6aFQ-mLPLeGZXFLyuK8d",
}

Контроллеры

Список Контроллеров Пользователя (list)

request: Request URL: [site]/api/ctrl/list/

параметры запроса: (string) token

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа: (array)

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

{
"0":{
	"id":"11",
	"name":"AS_A61301A020E4",
	"armed":"0",   //0 - снят с охраны, 1 - под охраной
	"device_ids":"a:3:{i:0;i:1;i:1;i:2;i:2;i:3;}", //ids устройств на контроллере
	"action_ids":"a:0:{}", //ids действий на контроллере
	"timezone":"3",
	"token":"747D3844ABD35B08F27D18D15D7178B7AF99A754D805633928D4362D19B4AEC2",
	"online":"1"
},
"1":{
	"id":"12",
	"name":"AS_A61301A020E5",
	"armed":"1",
	"device_ids":"a:3:{i:0;i:1;i:1;i:2;i:2;i:3;}",
	"action_ids":"a:0:{}",
	"timezone":"2",
	"token":"734D3844ABD35B08F27D18D15D7178B7AF99A754D805633928D4362D19B4AEC2",
	"online":"0"
}] 


Информация о Контроллере (info)

request: Request URL: [site]/api/ctrl/info/

параметры запроса: (int) controller_id , (string) token

Пример запроса:

{
	"controller_id": 1 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа: (object)

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

{
	"id":"6",
	"name":"AS_7F26335CCF4B",
	"armed":"1",
	"device_ids":"a:26:{i:0;i:25;i:1;i:26;i:2;i:28;i:3;i:19;i:4;i:40;i:5;i:41;i:6;i:42;i:7;i:43;i:8;i:36;i:9;i:34;i:10;i:29;i:11;i:45;i:12;i:38;i:13;i:33;i:14;i:30;i:15;i:31;i:16;i:49;i:17;i:24;i:18;i:46;i:19;i:47;i:20;i:44;i:21;i:27;i:22;i:22;i:23;i:9;i:24;i:23;i:25;i:7;}",
	"action_ids":"a:4:{i:0;i:45;i:1;i:46;i:2;i:49;i:3;i:42;}",
	"timezone":"3",
	"token":"660D91C2B0926A8C981AE7DA4AAA4421A3D86D136262A6F8E98ACF534A7A715B",
	"online":"1"
}

Постановка/снятие Контроллера на охрану / с охраны (armed)

request:

Request URL: [site]/api/ctrl/armed/

параметры запроса: (int) controller_id , (string) token пример:

{
	"controller_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

так как MQTT односторонний - ответа быть не может. Ответ что запрос ушел: response: параметры ответа: пример:

{
	"result": "Ok"
}


Добавление Контроллера (add)

request:

Request URL: [site]/api/ctrl/add

параметры запроса: (string) token

Пример:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response: параметры ответа: пример:

{
	"PIN":"7gDH"
}

После ввода пин-кода необходимо обновить список Контроллеров (/api/ctrl/list/)

Обновление списка устройств и действий на Контроллере (update)

Этап 1 - обновляем список IDS устройств на Контроллере

request:

Request URL: [site]/api/ctrl/update/ параметры запроса: (int) controller_id , (string) token пример:

{
	"controller_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response: параметры ответа: пример:

{
	"result": "Ok" // "Ok" = запрос ушел
}

Этап 2 - обновляем информацию о каждом устройстве

request: Request URL: [site]/api/ctrl/update-devices/

параметры запроса:

(int) controller_id, (string) token

Пример запроса:

{
	"controller_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
}

response:

параметры ответа:

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

{
	"result": "Ok" // ответ что запрос ушел
}

Процесс происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (контроллер, устройства)


Удаление Контроллера (delete)

Request URL: [site]/api/ctrl/delete

Параметры запроса:

Пример запроса:

{
	"token":"8yE-VIQrYuZ2bTeho_lajxjOJPnIe_Yx",
	"controller_id":"81"	
}

response: параметры ответа: пример:

{
	"error":null,
	"data":{"resuls":"Ok"}
}

Обновление статуса контроллера (update-status)

request:

Request URL: [site]/api/ ctrl/update-status/

Параметры запроса:

(string) token,

(int) controller_id

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"controller_id": 122
}

response:

параметры ответа:

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

{
	"error":null,
	"data":{
		"resuls":"Ok"
		}
}

Получение актуального статуса Контроллера (get-status)

request:

Request URL: [site]/api/ ctrl/get-status/

параметры запроса:

(string) token,

(int) controller_id

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"controller_id": 122
}

response:

параметры ответа:

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

{
	"error":null,
	"data":{
		"status":1
		}
}

Поле “status” может принимать следующие значения: • 0 – офлайн

• 1 – онлайн

• 2 – онлайн, после включения питания

Передача локального IP Контроллера (get-ip)

Request URL: [site]/api/ctrl/get-ip

Request Params:

token (required): string(64);

controller_id (required): int;

SUCCESS RESPONSE:

{
	data:'192.168.0.15',
	error: null
}

Установка подписки на Контроллере

in/subscription/set

Request URL: [site]/in/subscription/set”

{
	"seq_id": 0,
	"id": 1, // ID подписки (см. ниже)
	"remain_time": 100 // оставшееся время в секундах, 4294967295 - неограниченно
}

Просмотр статуса подписки (get-subscribe-status)

Request URL: [site]/api/ctrl/get-subscribe-status

params:

token (required): string(64)

controller_id (required): int

response:

{data:{id: 1, controller_id: 40, user_id: 424, remain_time: 100, request_time: 1355314332, response_time: 1355315332, success: 0}, error: }


Активация/продление/покупка подписки (set-subscribe)

Request URL: [site]/api/ctrl/set-subscribe

params:

token (required): string(64)

controller_id (required): int

response:

{
	data:{
		id: 1,
		controller_id: 40,
		user_id: 424,
		remain_time: 100,
		request_time: 1355314332,
		response_time: 1355315332,
		success: 0
	},
	error: ''
}


Метод получения списка телефонов (get-phones)

Request URL: [site]/api/ctrl/get-phones

Params:

token (required): string, 64

controller_id (required): int

type (optional): string, range ['recipient', 'authorized', 'all'], default 'all'

Response:

{
	'error': null,
	data: [
		{'id': 5, 'phone': '+380123456789'},
		{'id': 6, 'phone': '+380123334455'},
		{'id': 7, 'phone': '+380112223344'}
	]
}


Редактирование телефона (edit-phone)

Request URL: [site]/api/ctrl/edit-phone

Params:

token (required): string, 64

phone_id (required): int

is_recipient (optional): int

is_authorized (optional): int

phone (optional): string

Response:

{
	"error":null,
	"data":{
		"id":2,
		"controller_id":81,
		"phone":"+380503334455",
		"is_recipient":"1",
		"is_authorized":0
	}
}


Удаление телефона (delete-phone)

Request URL: [site]/api/ctrl/delete-phone

Params:

token (required): string, 64

phone_id (required): int

Response:

{
	"error":null,
	"data":{"response":"OK"}
}

Добавление телефона (add-phone)

Request URL: [site]/api/ctrl/add-phone

Params:

token (required): string, 64

controller_id (required): int

phone (required): string

is_recipient (optional): int

is_authorized (optional): int

Response:

{
	"error":null,
	"data":{
		"id":2,
		"controller_id":81,
		"phone":"+380503334455",
		"is_recipient":"1",
		"is_authorized":0
	}
}

Устройства

Получение списка устройств пользователя (list)

request:

Request URL: [site]/api/device/list

параметры запроса: (int) controller_id , (string) token

Пример запроса:

{
	"controller_id": 1 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response: параметры ответа:

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

{
"0":{
	"id":"122",
	"external_id":"19", //id на контроллере
	"controller_id":"6",
	"name":"Сирена",
	"type_id":"2",  //тип устройства
	"codes":":{     //коды (кнопки)
		"0":{
		"id":"218",
		"external_cod_id":"32",
		"device_id":"122",
		"name":"ON",
		"code":"3675192",
		"protocol":"1",
		"pulse_len":null,
		"group_1":"1",
		"group_2":"0",
		"group_3":"0",
		"group_4":"0",
		"group_5":"0",
		"group_6":"0",
		"group_7":"0",
		"group_8":"0",
		"active":"1"
		}, 
		"1":{ ... }
	},
	"state":"1",
	"on_dashboard":"1", //показывать на главной
	"active":"1"  
},
"1":{
	"id":"120",
	"external_id":"22",
	"controller_id":"6",
	"name":"Пульт 4кн бел",
	"type_id":"3",
	"codes": ... ,
	"state":"1",
	"on_dashboard":"0",
	"active":"1"
}
}  


Информация об устройстве (info)

request:

Request URL: [site]/api/device/info/

параметры запроса:

(int) controller_id,

(int) device_id,

(string) token

Пример запроса:

{
	"controller_id": 1 ,
	"device_id": 122,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа:

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

{
	"id":"122",
	"external_id":"19",
	"controller_id":"6",
	"name":"Сирена",
	"type_id":"2",
	"codes":{
		"0":{
		"id":"218",
		"external_cod_id":"32",
		"device_id":"122",
		"name":"ON",
		"code":"3675192",
		"protocol":"1",
		"pulse_len":null,
		"group_1":"1",
		"group_2":"0",
		"group_3":"0",
		"group_4":"0",
		"group_5":"0",
		"group_6":"0",
		"group_7":"0",
		"group_8":"0",
		"active":"1"
		},
		"1":{
		"id":"219",
		"external_cod_id":"33",
		"device_id":"122",
		"name":"OFF",
		"code":"3675186
		...
		}
	},
	"state":"1",
	"on_dashboard":"1",
	"active":"1"
}


Обновление информации об устройстве (update)

request:

Request URL: [site]/api/device/update/

параметры запроса:

(int) device_id,

(string) name,

(int) active,

(string) token,

Пример запроса:

{
	"device_id": 107,   // local device id
	"name": "New name", // new name
	"active": 1,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа:

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

{
	"resuls" : "Ok"
}

Удаление устройства (delete)

request:

Request URL: [site]/api/device/delete/

параметры запроса:

(int) device_id,

(string) token

Пример запроса:

{
	"device_id": 107,   // local device id
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

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

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

{
	"resuls" : "Ok"

}


Получение метеоданных (last)

request: Request URL: [site]/api/device/meteo-last/

параметры запроса:

(string) token,

(int) device_id

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id": 130
}

response:

параметры ответа: (object)

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

{
	"id":"4046",
	"controller_name":"AS_7FD6785CCF5D",
	"internal_id":"55",
	"device_id":"130",
	"name":"7",
	"temp":"240",
	"hum":"245",
	"illum":"0",
	"pres":"1239",
	"volt":"32",
	"date_time":"2016-03-02 21:09:40",
	"new":"0"  
}

Получение метеоданных за период (period)

request:

Request URL: [site]/api/device/meteo-period/

параметры запроса:

(string) token,

(int) device_id,

(int) period

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id": 130,
	"period": 1 // количество дней 
}

response:

параметры ответа: (array to objects)

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

[
	{
	"id":"4065",
	"controller_name":"AS_7FD6785CCF5D",
	"internal_id":"55",
	"device_id":"130",
	"name":"7",
	"temp":"240",
	"hum":"523",
	"illum":"0",
	"pres":"1239",
	"volt":"32",
	"date_time":"2017-07-30 21:11:07",
	"new":"0"
	},
	{
	"id":"4067",
	"controller_name":"AS_7FD6785CCF5D
	...
	},
]

Получение данных электропитания (last)

request: Request URL: [site]/api/device/electro-last/

параметры запроса:

(string) token,

(int) device_id

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id": 130
}

response:

параметры ответа: (object)

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

{
	"id":"318",
	"controller_id":"11",
	"external_id":"2",
	"device_id":"125",
	"name":"23",
	"token":"747D3844ABD35B08F27D18D15D7178B7AF99A754D805633928D4362D19B4AEC2",
	"last_seen":"2017-07-21 04:20:27",
	"available":"1",
	"voltage":"24",
	"have_voltage":"1",
	"current":"2147483647",
	"have_current":"1",
	"supp_voltage":"33",
	"date_create":"2017-07-21 01:20:33",
	"new":"0"
}

Получение данных электропитания за период (period)

request:

Request URL: [site]/api/device/electro-period/

параметры запроса:

(string) token,

(int) device_id,

(int) period

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id": 130,
	"period": 1 // количество дней 
}

response:

параметры ответа: (array to objects)

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

[
	{
	"id":"318",
	"controller_id":"11",
	"external_id":"2",
	"device_id":"125",
	"name":"23",
	"token":"747D3844ABD35B08F27D18D15D7178B7AF99A754D805633928D4362D19B4AEC2",
	"last_seen":"2017-07-21 04:20:27",
	"available":"1",
	"voltage":"24",
	"have_voltage":"1",
	"current":"2147483647",
	"have_current":"1",
	"supp_voltage":"33",
	"date_create":"2017-07-21 01:20:33",
	"new":"0"
	},
	{
	"id":"318",
	"controller_id":"11",
	...
	},
]

Получение данных о сторонних устройствах (other-last)

Метод возвращает информацию о последнем обнаруженном стороннем устройстве.

request:

Request URL: [site]/api/device/other-last/

Параметры запроса:

(string) token,

(int) device_id

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id": 118
}

response:

параметры ответа: (object)

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

{
	"id":"1301",
	"controller_id":"6",
	"device_id":"118",
	"name":"Розетка",
	"code":"81",
	"pulse_len":null,
	"bit_len":null,
	"protocol":null,
	"groups":null,
	"type":null,
	"date_time":"2017-08-21 04:55:18",
	"active":null,
	"new":"1"
}


Получение данных о сторонних устройствах за период (other-period)

request:

Request URL: [site]/api/device/other-period/

параметры запроса:

(string) token,

(int) device_id,

(int) period

Пример запроса: { "token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae", "device_id": 118, "period": 1 // количество дней } response:

параметры ответа: (array to objects)

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

{
	"id":"1301",
	"controller_id":"6",
	"device_id":"118",
	"name":"Розетка",
	"code":"81",
	"pulse_len":null,
	"bit_len":null,
	"protocol":null,
	"groups":null,
	"type":null,
	"date_time":"2017-08-21 04:55:18",
	"active":null,
	"new":"1"
	},
	{
	"id":"4067",
	"controller_id":"6",
	...
}

Wizard добавления устройств

Датчик открытия двери (create-door-open-sensor)

URL: [site]/api/wizard/create-door-open-sensor

Params: controller_id (required): int token (required): string, 64 device_name (optional): string, 256 code_ready (optional): string, 64 //Название кода готовности code_alarm (optional): string, 64 //Название кода оповещания code_low_battery (optional): string, 64 //Название кода садящейся батареи

RESPONSE:

{
	data:{
		'response': 'OK'
		},
	error: null
}

После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.


Датчик затопления (create-flood-sensor)

Request URL: [site]/api/wizard/create-flood-sensor

Params:

controller_id (required): int

token (required): string, 64

device_name (optional): string, 256 code_alarm (optional): string, 64 //Название кода оповещения

code_tamper (optional): string, 64 //Название кода вмешательства

code_low_battery (optional): string, 64 //Название кода садящейся батареи

RESPONSE:

{
	data: {
		'response': 'OK'
		},
	error: null
}

После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.


Пульт,4 кнопки (create-console)

Request URL: [site]/api/wizard/create-console

Params:

controller_id (required): int

token (required): string, 64

device_name (optional): string, 256

code_lock (optional): string, 64 //Название кода блокировки

code_unlock (optional): string, 64 //Название кода разблокировки

code_s (optional): string, 64 //Название кода s

code_alarm (optional): string, 64 //Название кода оповещения

RESPONSE:

{
	data: {
		'response': 'OK'
	},
	error: null
}

После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.


Сирена (create-siren)

Request URL: [site]/api/wizard/create-siren

Params:

controller_id (required): int

token (required): string, 64

device_name (optional): string, 256

code_on (optional): string, 64 //Название кода включения

code_off (optional): string, 64 //Название кода выключения

code_blank (optional): string, 64 //Название кода blank

RESPONSE:

{
	data: {
		'response': 'OK'
		},
	error: null
}

Перед отправкой параметров необходимо перевести сирену в режим обучения.


Метеостанция: получение списка обнаруженных метеостанций за последние 10 минут (get-meteos)

Request URL: [site]/api/wizard/get-meteos

Params:

controller_id (required): int

token (required): string, 64

RESPONSE:

{
	"error":null,
	"data":				 	[{"id":"93","controller_id":"79","date":"1528389351","type":"7","family":"0","rf_code":null,"rf_bit_len":null,"rf_pulse_len":null,"rf_protocol":null,"rf_freq":null,"ir_code":null,"ir_bit_len":null,"ir_address":null,"ir_protocol":null,"meteo_num":"0"}]
}

Метеостанция: добавление (create-meteo)

Request URL: [site][site]/api/wizard/create-meteo

Params:

controller_id (required): int

token (required): string, 64

meteo_num (required): int //Получается в списке выше

device_name (optional): string, 256

RESPONSE:

{
	"error":null,
	"data":{
		"response":"OK"
		}
}


Водопроводный кран

Порядок добавления крана: 1) Сгенерировать коды

2) Зажать на кране кнопку, пока кран не мигнёт трижды

3) Отправить один код

4) Нажать на кране кнопку однократно

5) Зажать на кране кнопку, пока не мигнёт 4 раза

6) Отправить второй код из сгенерированных

7) Нажать на кране кнопку однократно

8) Отправить запрос на создание крана.


Генерация кодов

Request URL: [site]/api/wizard/create-codes

Params:

controller_id (required): int

token (required): string, 64

Response:

{
	"error":null,
	"data":{"response":{"id":30,"masks":"[6,4,0,1]","code_1":"9920950","code_2":"9920948","code_3":"9920944","code_4":"9920945"}
		}
}


Выполнение кода

Request URL: [site]/api/wizard/execute-code

Params:

controller_id (required): int

token (required): string, 64

code (required): int // Берется из сгенерированных

Response:

{
	error: null,
	data: {
		"response":"OK"
		}
}

Добавление крана

Request URL: [site]/api/wizard/create-crane-by-codes

Params:

controller_id (required): int

token (required): string, 64

code_1 (required): int

code_2 (required): int

device_name (optional): string, 256

code_open (optional): string, 64 //Название кода открытия

code_close (optional): string, 64 //Название кода закрытия

RESPONSE:

{
	data:{'response': 'OK'},
	error: null
}

Добавление розетки

порядок добаления розетки следующий:

1) Сгенерировать коды

2) Зажать на розетке кнопку, пока она не начнет мигать

3) Отправить один код

4) Зажать на розетке кнопку, пока она не начнет мигать

5) Отправить второй код из сгенерированых

6) Отправить запрос на создание розетки


Генерация кодов (create-codes)

Request URL: [site]/api/wizard/create-codes

Params:

controller_id (required): int

token (required): string, 64

socket (required): любое значение.

Response:

{
	"error":null,
	"data":{
		"response":{"id":30,"masks":"[257, 258]","code_1":"8737025","code_2":"8737026"}
		}
}


Выполнение кода (execute-code)

Request URL: [site]/api/wizard/execute-code

Params:

controller_id (required): int

token (required): string, 64

code (required): int // Берется из сгенерированных

Response

{
	error: null,
	data: {'response' => 'OK'}
}


Добавление розетки (create-socket)

Request URL: [site]/api/wizard/create-socket

Params:

controller_id (required): int

token (required): string, 64

code_1 (required): int

code_2 (required): int

device_name (optional): string, 256

code_off (optional): string, 64 //Название кода открытия

code_on (optional): string, 64 //Название кода закрытия

RESPONSE:

{
	data: {'response':'OK'},
	error: null
}

Сценарии

Список сценариев (list)

request: Request URL: [site]/api/scheduler/list/

параметры запроса: (string) token

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа:

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

{
"0":{
	"id":9,
	"external_id":42,
	"name":"test_form_web",
	"operation":"local",
	"armed":0,
	"type":"meteo",
	"action_id":1,
	"a_controller_id":6,
	"a_device_id":112,
	"a_code_id":0,
	"a_device_external_id":38,
	"a_armed":0,
	"a_conf1":0,
	"a_conf2":0,
	"a_conf3":0,
	"a_conf4":0,
	"a_conf5":0,
	"a_conf6":0,
	"a_conf7":0,
	"a_conf8":0,
	"target_id":1,
	"t_controller_id":6,
	"t_device_id":119,
	"t_code_id":203,
	"t_device_external_id":7,
	"t_armed":0,
	"t_conf1":0,
	"t_conf2":0,
	"t_conf3":0,
	"t_conf4":0,
	"t_conf5":0,
	"t_conf6":0,
	"t_conf7":0,
	"t_conf8":0,
	"date":null,
	"repetition":"0",
	"sensor_type":"1",
	"logic_operation":"=",
	"value":"3",
	"active":1
	},
"1":{
	"id":10,
	"external_id":45
	...
	} 
}


Обновление сценариев (update)

Запрос осуществляется в 2 этапа: на первом этапе происходит при запросе на обновление Контроллера (см. "Обновление Контроллера"); на втором этапе обновляется информация о каждом действии.

request: Request URL: [site]/api/scheduler/update/

параметры запроса:

(int) controller_id,

(string) token

Пример запроса:

{
	"controller_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
}

response:

параметры ответа:

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

{
	"result": "Ok" // ответ что запрос ушел
}

Процесс обновления происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (Контроллер, действия)


Информация о сценарии (info)

request: Request URL: [site]/api/scheduler/info/

параметры запроса:

(int) scheduler_id,

(string) token

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

{
	"scheduler_id": 122,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response:

параметры ответа:

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

{
	"id":9,
	"external_id":42,
	"name":"test_form_web",
	"operation":"local",
	"armed":0,
	"type":"meteo",
	"action_id":1,
	"a_controller_id":6,
	"a_device_id":112,
	"a_code_id":0,
	"a_device_external_id":38,
	"a_armed":0,
	"a_conf1":0,
	"a_conf2":0,
	"a_conf3":0,
	"a_conf4":0,
	"a_conf5":0,
	"a_conf6":0,
	"a_conf7":0,
	"a_conf8":0,
	"target_id":1,
	"t_controller_id":6,
	"t_device_id":119,
	"t_code_id":203,
	"t_device_external_id":7,
	"t_armed":0,
	"t_conf1":0,
	"t_conf2":0,
	"t_conf3":0,
	"t_conf4":0,
	"t_conf5":0,
	"t_conf6":0,
	"t_conf7":0,
	"t_conf8":0,
	"date":null,
	"repetition":"0",
	"sensor_type":"1",
	"logic_operation":"=",
	"value":"3",
	"active":1
}


Логи пользователя (logs)

request:

Request URL: [site]/api/profile/logs/

параметры запроса: (string) token

Пример запроса:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

response: параметры ответа: (object) пример: {

}




Коды

Получение информации о коде (info)

request:

Request URL: [site]/api/property/info/

параметры запроса: (int) controller_id,

(int) device_id,

(int) code_id,

(string) token

Пример запроса:

{
	"controller_id": 6,
	"device_id": 109, 
	"code_id": 192,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"

}

response: параметры ответа:

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

{
	"id":"192",
	"external_cod_id":"67",
	"device_id":"109",
	"name":"4 OFF",
	"code":"12209156",
	"protocol":"1",
	"pulse_len":null,
	"group_1":"1",
	"group_2":"0",
	"group_3":"0",
	"group_4":"0",
	"group_5":"0",
	"group_6":"0",
	"group_7":"0",
	"group_8":"0",
	"active":"1"
}


Изменение имени кода (update-code-name)

Request URL: [site]/api/device/update-code-name

Request Params:

token (required): string(64)

code_id (required): int

name (optional): string(255)

SUCCESS RESPONSE:

{
	data: {
		'message': "OK"
		},
	error: null
}

Получение кодов по типу сигнала (get-codes-by-subtype)

Request URL: [site]/api/device/get-codes-by-subtype

Request Params:

token (required): string(64)

device_subtype_id (optional): int, default 0.

Получение списка кодов (get-codes)

Request URL: [site]/api/device/get-codes

PARAMS: token (required): string 64

controller_id (required): int

SUCCESS RESPONSE:

{
	data: [
		{
			devices:	[
			{
				id:	13
				external_id:	7,
				controller_id:	5,
				name:	"Simple device",
				type_id:	2,
				password:	null,
				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
				state:	1,
				on_dashboard:	0,
				active:	1,
				new:	1,
				family:	DEVICE_FAMILY_RADIO,
				camera_id:	null,
				camera_host:	null
			},
			{
				id:	14
				external_id:	8,
				controller_id:	5,
				name:	"Simple device",
				type_id:	2,
				password:	null,
				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
				state:	1,
				on_dashboard:	0,
				active:	1,
				new:	1,
				family:	DEVICE_FAMILY_RADIO,
				camera_id:	null,
				camera_host:	null
			},
		],
		code: {
			id:	12,
			controller_id: 5,
			device_type_id:	2,
			code: 498654,
			protocol: 1,
			bit_len: 32,
			pulse_len:	86,
			freq:	77,
			address:	94,
			num:	1,
			date_create: '2018-04-13 18:29:11"

		}
		}, 

		{
			devices:	[
			{
				id:	13
				external_id:	7,
				controller_id:	5,
				name:	"Simple device",
				type_id:	2,
				password:	null,
				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
				state:	1,
				on_dashboard:	0,
				active:	1,
				new:	1,
				family:	DEVICE_FAMILY_RADIO,
				camera_id:	null,
				camera_host:	null
			},
			{
				id:	14
				external_id:	8,
				controller_id:	5,
				name:	"Simple device",
				type_id:	2,
				password:	null,
				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
				state:	1,
				on_dashboard:	0,
				active:	1,
				new:	1,
				family:	DEVICE_FAMILY_RADIO,
				camera_id:	null,
				camera_host:	null
			},
		],
		code: {
			id:	12,
			controller_id: 5,
			device_type_id:	2,
			code: 498654,
			protocol: 1,
			bit_len: 32,
			pulse_len:	86,
			freq:	77,
			address:	94,
			num:	1,
			date_create: '2018-04-13 18:29:11"

		}
		}, 
	},
	error: null,
}

Добавление кода к устройству (set-code-to-device)

Request URL: [site]/api/device/set-code-to-device

PARAMS:

token (required): string 64

code_id (required): int

device_id (required): int

name (optional): string 256

SUCCESS RESPONSE:

{
	data:	{
		id: 5,
		external_cod_id: 15,
		device_id: 14,
		name: "Name"
		code: 8463517,
		protocol: 0,
		pulse_len:	86, 
		active: 1,
	},
	error: null
}

Удаление кода (remove-code)

Request URL: [site]/api/device/remove-code PARAMS:

token (required): string 64

code_id (required): int

SUCCESS RESPONSE:

{
	data:	{
		message: "OK"
	},
	error: null
}

События

Нажатие кнопки на устройстве (event)

request:

Request URL: [site]/api/device/event/ параметры запроса:

(string) controller_name,

(int) device_external_id,

(int) cod_external_id,

(string) token,

(int) device_type

Пример запроса:

{
	"controller_name": " AS_7F26335CCF4B" ,
	"device_external_id": 19,
	"cod_external_id": 1,
	"device_type": 1,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

так как MQTT односторонний - ответа быть не может. Может быть возвращён ответ, что запрос отправлен: response:

параметры ответа:

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

{
	"result": "Ok"
}

Места

Получение списка мест (places-list)

Request URL: [site]/api/places/places-list

Request params:

token (required): string, 64

Response:

{
	"error":null,
	"data":{
		"rooms":[{"id":1,"root_id":1,"user_id":424,"lvl":0,"name":"Дом","icon":0,"icon_type":1,"color":"#fff2cc","readonly":0,"visible":1},{"id":2,"root_id":1,"user_id":424,"lvl":1,"name":"Спальня","icon":0,"icon_type":1,"color":"#b6d7a8","readonly":0,"visible":1}]
		}
}


Создание места (create)

Request URL: [site]/api/places/create

Request params:

token (required): string, 64

root (optional): int, default 1

lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5

rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5

lvl (optional): int, default 0

name (optional): string, 64, default 'Simple name'

icon (optional): string, default //Допускаемые параметры -- ключи объекта выше

color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна

active (optional): int, default 1

selected (optional): int, default 0

disabled (optional): int, default 0

readonly (optional): int, default 0

visible (optional): int, default 1

collapsed (optional): int, default 0

movable_u (optional): int, default 1

movable_d (optional): int, default 1

movable_l (optional): int, default 1

movable_r (optional): int, default 1

removable (optional): int, default 1

removable_all (optional): int, default 0

inverse_text (optional): string, default 'black'


Response:

{
	error:null,
	data: {'message': 'OK'}
}


Редактирование места (edit)

Request URL: [site]/api/places/edit

Request params:

token (required): string, 64

place_id (required): int

root (optional): int, default 1

lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5

rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5

lvl (optional): int, default 0

name (optional): string, 64, default 'Simple name'

icon (optional): string, default //Допускаемые параметры -- ключи объекта выше

color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна

active (optional): int, default 1

selected (optional): int, default 0

disabled (optional): int, default 0

readonly (optional): int, default 0

visible (optional): int, default 1

collapsed (optional): int, default 0

movable_u (optional): int, default 1

movable_d (optional): int, default 1

movable_l (optional): int, default 1

movable_r (optional): int, default 1

removable (optional): int, default 1

removable_all (optional): int, default 0

inverse_text (optional): string, default 'black'


Response:

{
	error:null,
	data: {'message': 'OK'}
}

Удаление места (delete)

Request URL: [site]/api/places/delete

Request params:

token (required): string, 64

place_id (required): int

Response:

{
	error:null,
	data: {'message': 'OK'}
}



Активация подписки Ebus

Получение состояния подписки на Контроллере - “in/subscription/get”:

{
	"id": 1, // ID подписки (см. ниже)
	"seq_id": 0
}

Ответ:

{
	"seq_id": 0,
	"remain_time": 100, // оставшееся время в секундах, 4294967295 – неограниченно
	"success": 0/1
}

Установка подписки на Контроллере - “in/subscription/set”:

{
	"seq_id": 0,
	"id": 1, // ID подписки (см. ниже)
	"remain_time": 100 // оставшееся время в секундах, 4294967295 - неограниченно
}

Ответ:

{
	"seq_id": 0,
	"success": 0/1
}

Идентификаторы подписок: SUBSCRIPTION_EBUS = 1

Статус Контроллера

Контроллер отправляет информацию о своем онлайн/оффлайн статусе в топик “out/status”.

Формат сообщения:

{
	"status": 1 // см. ниже
}

Поле “status” может принимать следующие значения:

• "0" – оффлайн

• "1" – онлайн

• "2" – онлайн, после включения питания

При получении сообщения со статусом "2", портал должен отправить Контроллеру информацию о пользовательских подписках, как это описано в разделе «Подписки».


Ошибки

параметры ошибки:

пример:

{
	"errors":{
		"password": [
			"Incorrect username."
		]
	}
}