Текущая версия на 16:12, 30 июля 2019

Другие языки:

English • ‎русский • ‎українська • ‎中文（中国大陆）‎

API v01 *

API ( json )

Содержание

1 Общие сведения
2 Учётная запись
3 Контроллеры
4 Устройства
5 Wizard добавления устройств
6 Сценарии
7 Логи пользователя (logs)
8 Коды
9 События
- 9.1 Нажатие кнопки на устройстве (event)
10 Места
11 Виджеты
12 Неклассифицируемые методы
- 12.1 Список доступных стран (countries)
13 Ошибки

Общие сведения

Обмен данными между Пользователем и серверной частью системы Quadrobit Smart Home осуществляется путём отправки пакетов (запросов и ответов). Пакет отправляется по HTTP методом POST на указанный адрес Request URL.

Запрос может содержать JSON-структуру, включающую один или несколько параметров. После успешной авторизации Пользователя запрос всегда должен содержать параметр token.

В ответ на полученный запрос Сервер возвращает Пользователю следующую JSON-структуру:

{
	error: null,
	data: { ... }	
}

Параметр error содержит информацию о результате выполнения запроса. error: null - запрос выполнен успешно.

Структура и содержание параметра data определяется типом запроса.

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

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

Запрос:

Request URL: [site]/api/login

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

(string) email,
(string) password

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

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

Ответ:

Пример ответа (data):

{
	"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 URL: [site]/api/registration

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

(string) email,
(string) password

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

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

Ответ:

Пример ответа (data):

{
    	"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 URL: [site]/api/profile/

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

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

Ответ:

Пример ответа (data):

{
	"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 URL: [site]/api/ctrl/list/

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

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

Ответ:

Пример ответа (data):

{
"0":{
	"id": 651,
	"name": "AE439648F951",
	"ip": "192.168.10.135",
	"fw_id": "1",
	"hostname": "quadrobase",
	"armed": 0,
	"address": "",
	"lat": null,
	"lng": null,
	"timezone": 2,
	"online": 1,
	"last_online": "2019-06-17 19:36:48",
	"type_signal": "wifi",
	"wifi_param": -67,
	"gsm_param": 0,
	"phone": "",
	"pin": 0,
	"user_controller_name": "quadrobase",
	"on_dashboard": 0
}]

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

Запрос:

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

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

(int) controller_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"id":"6",
	"name":"66D4E809EF0A",
	"hostname":"Test Valera 34",
	"armed":0,
	"address":"",
	"lat":50.4156,
	"lng":30.5336,
	"ip":"192.168.1.155",
	"fw_id":1,
	"timezone":3,
	"online":1,
	"last_online":"2019-07-29 17:08:41",
	"type_signal":"wifi",
	"wifi_param":-78,
	"gsm_param":0,
	"phone":"",
	"pin":0,
	"user_controller_name":"Test Valera 34",
	"on_dashboard":0
}

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

Запрос:

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

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

№(int) controller_id, №(string) token

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

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

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

Ответ:

Пример ответа (data):

{
	"result": "Ok"
}

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

Запрос:

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

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

Пример:

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

Ответ:

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

{
	"PIN":"7gDH"
}

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

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

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

Запрос:

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

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

(int) controller_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"result": "Ok" // "Ok" = запрос отправлен
}

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

Запрос:

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

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

(int) controller_id,
(string) token

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

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

Ответ:

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

{
	"result": "Ok" // Запрос отправлен
}

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

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

Запрос:

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

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

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

Ответ:

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

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

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

Запрос:

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

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

(string) token,
(int) controller_id

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

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

Ответ:

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

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

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

Запрос:

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

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

(string) token,
(int) controller_id

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

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

Ответ:

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

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

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

• 1 – онлайн

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

Получение конфигурации Контроллера (config)

Запрос:

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

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

(string) token,
(int) controller_id

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

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

Ответ:

Пример ответа (data):

{
	"id":"1",   // id конфигурации
	"controller_id":"111",   // id контроллера
	"language":"ru-RU",
	"hostname":"alarm-system",
	"wifi_mode":1,   // 1 - STA, 2 - AP
	"wifi_sta_type":1, // 0 - STATIC, 1 - DHCP
	"wifi_sta_ssid":"SSID",
	"wifi_sta_pass":"PASSWORD",
	"wifi_sta_ip":"192.168.0.101",
	"wifi_sta_mask":"255.255.255.0",
	"wifi_sta_gw":"192.168.0.1",
	"wifi_sta_dns1":"208.67.222.222",
	"wifi_sta_dns2":"208.67.222.222",
	"wifi_ap_authmode": 3, // 0 - OPEN, 1 - WEP, 2 - WPA_PSK, 3 - WPA2_PSK, 4 - WPA_WPA2_PSK
	"wifi_ap_hidden":0, // 0/1
	"wifi_ap_channel":1, // 1...14
	"wifi_ap_ssid":"SMARTHOME_000000000000",
	"wifi_ap_pass":"00000000",
	"wifi_ap_ip":"192.168.4.1",
	"wifi_ap_mask":"255.255.255.0",
	"wifi_ap_gw":"192.168.4.1",
	"httpd_port":80, // 1...65535
	"httpd_auth":0, // 0/1
	"httpd_user":"admin",
	"httpd_pass":"admin",
	"ntp_enable":0, // 0/1
	"ntp_host":"time.windows.com",
	"ntp_tz":3, // -11...13
	"upnp_enable":1, // 0/1
	"advanced_mode":0, // 0/1 
	"app_afb_enable":1, // 0/1
	"app_leds_off":1, // 0/1
	"app_alarm_duration":10, // minutes
	"app_arming_delay":0, // seconds
	"app_portal_link":0, // 0/1
	"app_rf_freq":2, // 1 - 315Mhz, 2 - 433Mhz
	"app_rf_power":3, // 0 - 1DBM, 1 - 2DBM, 2 - 5DBM, 3 - 8DBM, 4 - 11DBM, 5 - 14DBM, 6 - 17DBM, 7 - 20DBM
	"app_button_action":1, // 0 - NONE, 1 - ARMING, 2 - RUN_ACTION, 3 - SEND_CODE
	"app_button_rec_id":0, // ID
	"gsm_pin":"1234",
	"gsm_allowed_phones":"", // список через запятую
	"gsm_sendto_phones":"", // список через запятую
	"gsm_callto_phones":"", // один номер
	"gsm_smsin_enable":"0", // 0/1
	"gsm_smsout_enable":"0", // 0/1
	"gsm_call_enable":"0", // 0/1
	"gprs_enable":"1", // 0/1
	"gprs_apn":"", "internet.mts.ru",
	"gprs_user":"mts",
	"gprs_pass":"mts",
	"gsm_enable":"0", // 0/1
	"ebus_enable":0, // 0/1
	"command":"xxx",
	"response":"0"
}

Изменение конфигурации контроллера(config-set)

Запрос:

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

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

(string) token,
(int) controller_id

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"controller_id" : 111,
	"command": "yyy"    // параметры контроллера смотри метод Получить конфигурацию контроллера(ctrl/config/)
}

Ответ:

Пример ответа (data):

{
	"result": "Ok"
}

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

Запрос

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

Request Params:

token (required): string(64);
controller_id (required): int;

Ответ:

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

{
	data:'192.168.0.15',
	error: null
}

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

Запрос:

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

Ответ:

Пример ответа (data):

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

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

Запрос:

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

Параметры:

token (required): string(64)
controller_id (required): int

Ответ:

Пример ответа (data):

{
	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

Параметры:

token (required): string(64)
controller_id (required): int

Ответ:

{
	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

Параметры:

token (required): string, 64
controller_id (required): int
type (optional): string,
range ['recipient', 'authorized', 'all'], (default: 'all')

Ответ:

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

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

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

Запрос:

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

Параметры:

token (required): string, 64
phone_id (required): int
is_recipient (optional): int
is_authorized (optional): int
phone (optional): string

Ответ:

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

{
	"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

Параметры:

token (required): string, 64
phone_id (required): int

Ответ:

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

{
	"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

Ответ:

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

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

Информация о версии прошивки контроллера (fw-version-current)

Запрос:

Request URL: [site]/api/ctrl/fw-version-current/

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

(int) controller_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"version_id":1,
	"version_name":"0.01",
	"tag":"OLD",
	"url":"\/controllers_fw\/NULL.bin",
	"date":"16.10.2018",
	"new_version_id":38   // если "new_version_id" != "version_id" значит имеется новая версия.
}

Информация о последней версии прошивки контроллера (get-new-fw-version)

Запрос:

Request URL: [site]/api/ctrl/get-new-fw-version/

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

(int) controller_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"version_id":38,
	"version_name":"0.14",
	"tag":"0.14 \/ Oct 5 2018 16:49:04",
	"url":"\/controllers_fw\/tls-smarthome-hw-9_0.14.bin",
	"date":"16.10.2018"
}

Устройства

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

Запрос:

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

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

(int) controller_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
"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 URL: [site]/api/device/info/

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

(int) controller_id,
(int) device_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"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",
	"alias":"xxx",
	"send_sms ":0,
	"voice_call":0,
	place"
		"name":null,
		"color":null
		}
}

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

Запрос:

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

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

(int) device_id,
(string) name,
(int) active,
(string) token,

Пример запроса (data):

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

Ответ:

Пример ответа (data):

{
	"result" : "Ok"
}

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

Запрос:

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

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

(int) device_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
	"result" : "Ok"
}

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

Запрос:

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

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

(string) token,
(int) device_id

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

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

Ответ:

Пример ответа (data):

{
	"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 URL: [site]/api/device/meteo-period/

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

(string) token,

(int) device_id,

(int) period

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

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

Ответ:

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

Пример ответа (data):

[
	{
	"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 URL: [site]/api/device/electro-last/

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

(string) token,
(int) device_id

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

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

Ответ:

Пример ответа (data):

{
	"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 URL: [site]/api/device/electro-period/

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

(string) token,
(int) device_id,
(int) period

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

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

Ответ:

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

Пример ответа (data):

[
	{
	"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 URL: [site]/api/device/other-last/

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

(string) token,
(int) device_id

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

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

Ответ:

Пример ответа (data):

{
	"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 URL: [site]/api/device/other-period/

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

(string) token,
(int) device_id,
(int) period

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

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

Ответ:

Пример ответа (data):

{
	"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

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

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 //Название кода садящейся батареи

Ответ:

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

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

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

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

Запрос:

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

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

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 //Название кода садящейся батареи

Ответ:

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

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

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

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

Запрос:

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

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

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 //Название кода оповещения

Ответ:

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

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

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

Сирена (create-siren)

Запрос:

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

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

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

Ответ:

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

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

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

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

Запрос:

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

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

controller_id (required): int
token (required): string, 64

Ответ:

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

{
	"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

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

controller_id (required): int
token (required): string, 64
meteo_num (required): int //Получается в списке выше
device_name (optional): string, 256

Ответ:

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

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

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

Порядок добавления крана:

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

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

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

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

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

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

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

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

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

Запрос:

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

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

controller_id (required): int
token (required): string, 64

Ответ:

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

{
	"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

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

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

Ответ:

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

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

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

Запрос:

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

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

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 //Название кода закрытия

Ответ:

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

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

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

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

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

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

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

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

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

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

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

Запрос:

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

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

controller_id (required): int
token (required): string, 64
socket (required): любое значение.

Ответ:

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

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

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

Запрос:

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

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

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

Ответ:

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

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

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

Запрос:

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

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

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 //Название кода закрытия

Ответ:

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

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

Сценарии

Получение списка сценариев (list)

Запрос:

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

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

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

Ответ:

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

{
"error":null,
"data"
	"schedulers":[
	{
		"id":83,
		"external_id":23,
		"name":"Test 444",
		"operation":"local",
		"armed":2,
		"type":"meteo",
		"active":0,
		"action"
			"action_id":1,
			"controller_id":109,
			"device_id":1747,
			"code_id":1100,
			"device_external_id":64,
			"armed":1,
			"groups":7,
			"sensor_type":"1",
			"date":"00:00",
			"repetition":"1",
			"logic_operation":"=",
			"value":"9"
		},
		"target"
			"target_id":2,
			"controller_id":109,
			"device_id":0,
			"device_external_id":0,
			"code_id":0,
			"external_cod_id":0,
			"armed":0,
			"groups":168
		}
		},
		{
		"id":84,
		"external_id":24,
		...
		}]
	}
}

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

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

Запрос:

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

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

(int) controller_id,
(string) token

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

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

Ответ:

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

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

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

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

Запрос:

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

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

(int) scheduler_id,
(string) token

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

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

Ответ:

Пример ответа (data):

{
"id":107,
"external_id":6,
"name":"Test 1.1.1",
"operation":"local",
"armed":1,
"type":"device",
"active":1,
"action":{
	"action_id":1,
	"controller_id":111,
	"device_id":1824,
	"code_id":1399,
	"device_external_id":18,
	"armed":0,
	"groups":0,
	"sensor_type":"0",
	"date":null,
	"repetition":"0",
	"logic_operation":"=",
	"value":null
},
"targets":[
		{
		"id":87,
		"type_id":3,
		"controller_id":111,
		"device_id":0,
		"code_id":0,
		"device_external_id":0,
		"armed":1,
		"groups":0
		},
		{
		"id":88,
		"type_id":1,
		"controller_id":113,
		"device_id":13,
		"code_id":123,
		"device_external_id":1234,
		"armed":0,
		"groups":0
		},
	]
}

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

Обновление состоит из двух запросов: 1) обновление действия, вызывающего событие; 2) обновления целей сработки. При этом запросы можно делать независимо друг от друга.

Обновление/добавление действий и событий сценария (Update-action)

Request URL: [site]/api/scheduler/update-action/

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

(int) scheduler_id,
(string) token,
(string) name,
(int) "active"
(int) "send_sms" // 1 - отправлять / 0 - не отправлять
(int) "make_call" // 1 - отправлять / 0 - не отправлять
(int) "armed" // 0 - в любом режиме, 1 - в режиме охраны, 2 - без режима охраны
(int) "action_id",
(int) "action_device_id",
(int) "action_code_id",
(int) "action_armed",
(int) "action_groups", // битовая маска группы от 1 до 8
(string) "action_repetition", // только для расписания: номер дней повторения через запятую от 1 до 7
(string) "action_event_time", // только для расписания: время повторения
(int) "action_sensor_type", // только для метео устройств: 1 - напряжение, 2 - температура, 3 - влажность, 4 - Атм. давление, 5 - Освещенность , 0 - не выбрано
(string) "action_logic_operation", // логическая операция : '=', '!=', '<', '>', '<=', '>=', 'in', 'like'
(int) "action_value"

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

{
	"scheduler_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"name": "New name",
	"active": 1,
	"send_sms": 0, 
	"make_call": 1,
	"armed": 2,    
	"action_id" : 2,
	"action_device_id" : 2,
	"action_code_id" : 4,
	"action_armed" : 0,
	"action_groups" : 7,   
	"action_repetition" : "1,3",  
	"action_event_time" : "10:00",   
	"action_sensor_type" : 2, 
	"action_logic_operation" : "=",   
	"action_value" : 35,   
}

Ответ:

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

{
	"result": "Ok" // ответ о том, что запрос отправлен.
}

Обновление цели события (Update-target)

Request URL: [site]/api/scheduler/update-target/

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

(int) target_id,
(string) token,
(int) "target_type_id",
(int) "target_device_id",
(int) "target_code_id",
(int) "target_armed",
(int) "target_groups", // битовая маска группы от 1 до 8

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

{
	"target_id": 6 ,
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",   
	"target_type_id" : 2,
	"target_device_id" : 2,
	"target_code_id" : 4,
	"target_armed" : 0,
	"target_groups" : 7
}

Ответ:

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

{
	"result": "Ok" // ответ о том, что запрос отправлен.
}

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

Запрос:

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

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

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"page": 1 // номер страницы лога
	"limit": 20 // количество логов на странице , по умолчанию 20, максимум 100
}

Ответ:

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

[
	{
	"id":15,
	"controller":"Test Valera",
	"action_name":"",
	"device":"",
	"cod":"",
	"action_pack":"",
	"date_create":"2019-06-20 15:57:26",
	"status":0
	},
	{
	"id":14,
	"controller":"Test Valera",
	"action_name":"",
	"device":"",
	"cod":"",
	"action_pack":"",
	"date_create":"2019-06-20 15:57:18",
	"status":0	
        }
]

Коды

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

Запрос:

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"
}

Ответ:

Пример ответа (data):

{
	"id":"1465",
	"external_cod_id":"59",
	"device_id":"1866",
	"name":"alarm",
	"alias":"xxx",
	"code":"15779537",
	"msg_cod":"003001",
	"send_armed":"INFO",
	"send_disarmed":"INFO",
	"protocol":"1",
	"pulse_len":null,
	"group_1":"0",
	"group_2":"0",
	"group_3":"0",
	"group_4":"0",
	"group_5":"0",
	"group_6":"0",
	"group_7":"0",
	"group_8":"0",
	"active":"1",
	"send_sms":"0",
	"voice_call":"0"
}

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

Запрос: Request URL: [site]/api/device/update-code-name

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

token (required): string(64)
code_id (required): int
name (optional): string(255)

Ответ:

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

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

Редактирование параметров кода (update)

Запрос:

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

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

(string) token
(int) device_id
(int) code_id
(string) name // опционально
(int) active // опционально
(int) send_sms // опционально
(int) voice_call // опционально

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"device_id" : 111,
	"code_id" : 111,
	"send_sms": 1
}

Ответ:

Пример ответа (data):

{
	"result": "Ok"
}

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

Запрос:

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

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

token (required): string(64)
device_subtype_id (optional): int, default 0.

Ответ:

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

{
	"code"
	"id":131,
	"controller_id":109,
	"device_type_id":0,
	"device_subtype_id":1,
	"code":"655370",
	"protocol":1,
	"bit_len":24,
	"pulse_len":283,
	"freq":2,"address":null,
	"num":null,
	"date_create":"2019-03-13 17:35:05",
	"device_id":null
	},
	"devices":[
	{
		"id":"1684",
		"external_id":"64",
		"controller_id":"109",
		"name":"WS 1",
		"alias":null,
		"type_id":"12",
		"password":null,
		"codes":[178,179,180],
		"state":"1",
		"on_dashboard":"0",
		"active":"1",
		"new":"1",
		"family":"DEVICE_FAMILY_RADIO",
		"camera_id":null,
		"camera_host":null,
		"send_sms":"0",
		"voice_call":"0"
	},
	{
		"id":"1738",
		"external_id":"115",
		"controller_id":"109",
		"name":"Pult 123",
		"alias":null,
		"type_id":"3",
		"password":null,
		"codes":[280,281,282,283],
		"state":"1",
		"on_dashboard":"0",
		"active":"1",
		"new":"1",
		"family":"DEVICE_FAMILY_RADIO",
		"camera_id":null,
		"camera_host":null,
		"send_sms":"0",
		"voice_call":"0"
	}
	]
}

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

Запрос:

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

Параметры:

token (required): string 64
controller_id (required): int

Ответ:

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

{
	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

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

token (required): string 64
code_id (required): int
device_id (required): int
name (optional): string 256

Ответ:

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

{
	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

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

token (required): string 64
code_id (required): int

Ответ:

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

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

События

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

Запрос:

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:

Ответ:

Пример ответа (data):

{
	"result": "Ok"
}

Места

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

Запрос:

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

Параметры запроса: token (required): string, 64

Ответ:

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

{
	"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

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

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'

Ответ:

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

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

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

Запрос:

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

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

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'

Ответ:

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

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

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

Запрос: Request URL: [site]/api/places/delete

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

token (required): string, 64
place_id (required): int

Ответ:

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

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

Добавление устройства к месту, смена места у устройства (device-in-place)

Запрос:

Request URL: [site]/api/places/device-in-place/

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

token (required): string 64
device_id (required): int
place_id (required): int
visible (not required): int

Ответ:

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

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

Отвязать устройство от месту (device-out-place)

Запрос:

Request URL: [site]/api/places/device-out-place/

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

token (required): string 64
device_id (required): int
place_id (required): int

Ответ:

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

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

Получить список связей устройство-место (device-place-list)

Запрос:

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

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

token (required): string 64

Ответ:

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

{
	"error":null,
	"data":{
		"0":{
			"device_id":1336,
			"device_name":"Camera test",
			"place_id":8,
			"place_name":"office"
			},
			...
		"10":{
			"device_id":1865,
			"device_name":"Meteo 9",
			"place_id":10,
			"place_name":"Box 1"
			}
		}
}

Активация подписки 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", портал должен отправить Контроллеру информацию о пользовательских подписках, как это описано в разделе «Подписки».

Виджеты

Список виджетов пользователя (widget-list)

Запрос:

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

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

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
}

Ответ:

Пример ответа (data):

{
"widgets":[
	{
	"controller_id":111,
	"device_ids":[18,20,21,22],
	"device_id":"1824",
	"external_id":18,
	"device_type":3,
	"name":"Remote control",
	"widget_type":3,
	"state":1
	},
	{
	"controller_id":111,
	"device_ids":[18,20,21,22],
	"device_id":"1850",
	"external_id":20,
	"device_type":4,
	"name":"Sockets",
	"widget_type":4,
	"state":1
	}
   ],
"ctrl_widgets":[
   {
	"controller_id":111,
	"name":"66D4E809EF0A",
	"hostname":"Test",
	"armed":0
   }
]
}

Добавить виджет (widget-add-home)

Запрос:

Request URL: [site]/api/device/widget-add-home/

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

(string) token,
(int) device_id,
(int) controller_id

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

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

Ответ:

Пример ответа (полный):

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

Удалить виджет пользователя (widget-remove-home)

Запрос:

Request URL: [site]/api/device/widget-remove-home/

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

(string) token,
(int) device_id,
(int) controller_id

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

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

Ответ:

Пример ответа (полный):

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

Неклассифицируемые методы

Список доступных стран (countries)

Запрос:

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

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

(string) token
(string) lang // en , ua, ru

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

{
	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
	"lang" : "en"
}

Ответ:

Пример ответа (data):

[
	{
		"id":"1",
		"code":"AF",
		"name":"Afghanistan"
	},
	{
		"id":"2",
		"code":"AL",
		"name":"Albania"
	}
]

Ошибки

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

пример:

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

@@ Строка 1: / Строка 1: @@
+<languages />
+<translate>
+<!--T:1-->
 * API v01 *
+<!--T:2-->
 API ( json )
+<!--T:3-->
 URL https://quadrobit.com/
-= Авторизация (login) =
+= Общие сведения =
+Обмен данными между Пользователем и серверной частью системы Quadrobit Smart Home осуществляется путём отправки пакетов (запросов и ответов).
+Пакет отправляется по HTTP методом POST на указанный адрес Request URL.
+Запрос может содержать JSON-структуру, включающую один или несколько параметров.
+После успешной авторизации Пользователя запрос всегда должен содержать параметр token.
-request:
+В ответ на полученный запрос Сервер возвращает Пользователю следующую JSON-структуру:
+<pre>
+{
+	error: null,
+	data: { ... }
+}
+</pre>
+Параметр error содержит информацию о результате выполнения запроса. error: null - запрос выполнен успешно.
+Структура и содержание параметра data определяется типом запроса.
+= Учётная запись = <!--T:4-->
+== Авторизация (login) ==
+<!--T:5-->
+Запрос:
+<!--T:6-->
 Request URL: [site]/api/login
-параметры запроса:
+<!--T:7-->
+Параметры запроса:
-(string) email,
-(string) password
+<!--T:8-->
+#(string) email,
+#(string) password
+<!--T:10-->
 Пример запроса:
 <pre>
@@ Строка 25: / Строка 57: @@
 </pre>
-response:
+<!--T:11-->
-параметры ответа: (object)
+Ответ:
-Пример ответа:
+<!--T:12-->
+Пример ответа (data):
 <pre>
 {
@@ Строка 44: / Строка 77: @@
 }
+<!--T:13-->
 </pre>
-= Регистрация (registration) =
+== Регистрация (registration) == <!--T:14-->
+<!--T:15-->
+Запрос:
-request:
 Request URL: [site]/api/registration
-параметры запроса:
+<!--T:16-->
+Параметры запроса:
-(string) email,
-(string) password
+<!--T:17-->
+#(string) email,
+#(string) password
+<!--T:19-->
 Пример запроса:
 <pre>
@@ Строка 65: / Строка 103: @@
 }
 </pre>
-response:
+Ответ:
-параметры ответа: (object)
-пример:
+Пример ответа (data):
 <pre>
 {
@@ Строка 82: / Строка 120: @@
-= Профиль пользователя (profile) =
+== Профиль пользователя (profile) == <!--T:20-->
-request:
+<!--T:21-->
+Запрос:
+<!--T:22-->
 Request URL: [site]/api/profile/
-параметры запроса: (string) token
+<!--T:23-->
+Параметры запроса: (string) token
+<!--T:24-->
 Пример запроса:
 <pre>
@@ Строка 96: / Строка 138: @@
 }
 </pre>
-response:
+Ответ:
-параметры ответа: (object)
-пример:
+Пример ответа (data):
 <pre>
 {
@@ Строка 118: / Строка 160: @@
 </pre>
-= Список помещений Пользователя (rooms) =
+= Контроллеры = <!--T:25-->
-request:
+== Список Контроллеров Пользователя (list) == <!--T:26-->
-Request URL: [site]/api/profile/rooms/
+<!--T:27-->
+Запрос:
-параметры запроса:
+Request URL: [site]/api/ctrl/list/
-(string) token
+<!--T:28-->
+Параметры запроса: (string) token
-Пример запроса:
+<!--T:29-->
+Пример запроса:
 <pre>
 {
@@ Строка 135: / Строка 181: @@
 </pre>
-response:
+<!--T:30-->
+Ответ:
-параметры ответа: (object)
-Пример ответа:
+<!--T:32-->
+Пример ответа (data):
 <pre>
 {
 "0":{
-	"id":19,  //ID дирректории
+	"id": 651,
-	"root_id":0,  //ID корневой дирректории, 0 - верхний уровень
+	"name": "AE439648F951",
-	"user_id":10,
+	"ip": "192.168.10.135",
-	"lvl":0, // уровень вложенности текущей дирректории
+	"fw_id": "1",
-	"name":"Дом",
+	"hostname": "quadrobase",
-	"icon_id":21,
+	"armed": 0,
-	"icon_type":1,
+	"address": "",
-	"color":"#674ea7", //цвет фона
+	"lat": null,
-	"position":0,	//позиция сортировки
+	"lng": null,
-	"readonly":0,	// если 1 - только для чтения, нельзя изменять
+	"timezone": 2,
-	"visible":1	//активно/неактивно
+	"online": 1,
-},
+	"last_online": "2019-06-17 19:36:48",
-"1":{
+	"type_signal": "wifi",
-	"id":22,
+	"wifi_param": -67,
-	"root_id":19,
+	"gsm_param": 0,
-	...
+	"phone": "",
-	}
+	"pin": 0,
-}
+	"user_controller_name": "quadrobase",
+	"on_dashboard": 0
+}]
 </pre>
+== Информация о Контроллере (info) == <!--T:33-->
-= Информация о помещении (room-info) =
+<!--T:34-->
+Запрос:
-request:
-Request URL: [site]/api/profile/room-info/
+Request URL: [site]/api/ctrl/info/
-параметры запроса:
+<!--T:35-->
+Параметры запроса:
-(string) token,
-(int) room_id
+#(int) controller_id,
+#(string) token
+<!--T:36-->
 Пример запроса:
 <pre>
 {
-	"room_id":22,
+	"controller_id": 1 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+<!--T:37-->
+Ответ:
-Параметры ответа: (object)
+<!--T:39-->
+Пример ответа (data):
-Пример ответа:
+<!--T:40-->
 <pre>
 {
-	"id":19,  //ID локации
+	"id":"6",
-	"root_id":0,  //ID корневой локации, 0 - верхний уровень
+	"name":"66D4E809EF0A",
-	"user_id":10,
+	"hostname":"Test Valera 34",
-	"lvl":0, // уровень вложенности текущей локации
+	"armed":0,
-	"name":"Дом",
+	"address":"",
-	"icon_id":21,
+	"lat":50.4156,
-	"icon_type":1,
+	"lng":30.5336,
-	"color":"#674ea7", //цвет фона
+	"ip":"192.168.1.155",
-	"position":0,	//позиция сортировки
+	"fw_id":1,
-	"readonly":0,	// если 1 - только для чтения, нельзя изменять
+	"timezone":3,
-	"visible":1	//активно/неактивно
+	"online":1,
-	"devices_ids {  // IDs устройств прикрепленных к комнате
+	"last_online":"2019-07-29 17:08:41",
-		"0":101,
+	"type_signal":"wifi",
-		"1":103
+	"wifi_param":-78,
-		}
+	"gsm_param":0,
+	"phone":"",
+	"pin":0,
+	"user_controller_name":"Test Valera 34",
+	"on_dashboard":0
 }
 </pre>
+== Постановка/снятие Контроллера на охрану / с охраны  (armed) == <!--T:41-->
+<!--T:42-->
+Запрос:
-= Список Контроллеров Пользователя (list) =
+<!--T:43-->
+Request URL: [site]/api/ctrl/armed/
-request:
+<!--T:44-->
-Request URL: [site]/api/ctrl/list/
+Параметры запроса:
-параметры запроса: (string) token
+№(int) controller_id,
+№(string) token
 Пример запроса:
+<!--T:45-->
 <pre>
 {
+	"controller_id": 6 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+Так как MQTT односторонний - ответа быть не может. Ответ что запрос ушел:
-параметры ответа: (array)
+Ответ:
-Пример ответа:
+Пример ответа (data):
 <pre>
 {
-"0":{
+	"result": "Ok"
-	"id":"11",
+}
-	"name":"AS_A61301A020E4",
+</pre>
-	"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"
-}]
-</pre>
+== Добавление Контроллера (add) == <!--T:46-->
-= Информация о Контроллере (info) =
+<!--T:47-->
+Запрос:
-request:
+<!--T:48-->
-Request URL: [site]/api/ctrl/info/
+Request URL: [site]/api/ctrl/add
-параметры запроса: (int) controller_id , (string) token
+<!--T:49-->
+Параметры запроса: (string) token
-Пример запроса:
+<!--T:50-->
+Пример:
 <pre>
 {
-	"controller_id": 1 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+Ответ:
-параметры ответа: (object)
 Пример ответа:
 <pre>
 {
-	"id":"6",
+	"PIN":"7gDH"
-	"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"
 }
 </pre>
-= Постановка/снятие Контроллера на охрану / с охраны  (armed) =
+После ввода пин-кода необходимо обновить список Контроллеров (/api/ctrl/list/)
-request:
+== Обновление списка устройств и действий на Контроллере (update) == <!--T:51-->
-Request URL: [site]/api/ctrl/armed/
+=== Этап 1 - обновляем список IDS устройств на Контроллере === <!--T:52-->
+Запрос:
-параметры запроса: (int) controller_id , (string) token
+<!--T:53-->
-пример:
+Request URL: [site]/api/ctrl/update/
+Параметры запроса:
+#(int) controller_id,
+#(string) token
+Пример запроса:
 <pre>
 {
@@ Строка 305: / Строка 350: @@
 }
 </pre>
-так как MQTT  односторонний - ответа быть не может. Ответ что запрос ушел:
-response:
+Ответ:
-параметры ответа:
-пример:
+Пример ответа (data):
 <pre>
 {
-	"result": "Ok"
+	"result": "Ok" // "Ok" = запрос отправлен
 }
 </pre>
+=== Этап 2 - обновляем информацию о каждом устройстве === <!--T:54-->
-= Добавление Контроллера (add) =
+<!--T:55-->
+Запрос:
-request:
+Request URL: [site]/api/ctrl/update-devices/
-Request URL: [site]/api/ctrl/add
+<!--T:56-->
+Параметры запроса:
-параметры запроса: (string) token
+<!--T:57-->
+#(int) controller_id,
+#(string) token
-Пример:
+<!--T:58-->
+Пример запроса:
 <pre>
 {
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"controller_id": 6 ,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
 }
 </pre>
-response:
-параметры ответа:
+<!--T:59-->
-пример:
+Ответ:
+<!--T:61-->
+Пример ответа:
 <pre>
 {
-	"PIN":"7gDH"
+	"result": "Ok" // Запрос отправлен
 }
 </pre>
-После ввода пин-кода необходимо обновить список Контроллеров (/api/ctrl/list/)
-= Обновление списка устройств и действий на Контроллере (update) =
+Процесс происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (контроллер, устройства)
-=== Этап 1 - обновляем список IDS устройств на Контроллере ===
+== Удаление Контроллера (delete) == <!--T:62-->
-request:
-Request URL: [site]/api/ctrl/update/
+Запрос:
-параметры запроса: (int) controller_id , (string) token
-пример:
+<!--T:63-->
+Request URL: [site]/api/ctrl/delete
+<!--T:65-->
+Пример запроса:
 <pre>
 {
-	"controller_id": 6 ,
+	"token":"8yE-VIQrYuZ2bTeho_lajxjOJPnIe_Yx",
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"controller_id":"81"
 }
 </pre>
-response:
-параметры ответа:
+<!--T:66-->
-пример:
+Ответ:
+Пример ответа:
 <pre>
 {
-	"result": "Ok" // "Ok" = запрос ушел
+	"error":null,
+	"data":{"result":"Ok"}
 }
 </pre>
-=== Этап 2 - обновляем информацию о каждом устройстве ===
+== Обновление статуса контроллера (update-status) == <!--T:67-->
+<!--T:68-->
+Запрос:
+<!--T:69-->
+Request URL: [site]/api/ctrl/update-status/
-request:
+<!--T:70-->
-Request URL: [site]/api/ctrl/update-devices/
+Параметры запроса:
-параметры запроса:
+#(string) token,
+#(int) controller_id
-(int) controller_id,
+<!--T:73-->
-(string) token
+Пример запроса:
-Пример запроса:
 <pre>
 {
-	"controller_id": 6 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"controller_id": 122
 }
 </pre>
-response:
+<!--T:74-->
+Ответ:
-параметры ответа:
+<!--T:76-->
+Пример ответа:
-Пример ответа:
 <pre>
 {
-	"result": "Ok" // ответ что запрос ушел
+	"error":null,
+	"data":{
+		"result":"Ok"
+		}
 }
 </pre>
-Процесс происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (контроллер, устройства)
+== Получение актуального статуса Контроллера (get-status) ==  <!--T:77-->
+Запрос:
-= Удаление Контроллера (delete) =
+<!--T:78-->
+Request URL: [site]/api/ctrl/get-status/
-Request URL: [site]/api/ctrl/delete
+<!--T:79-->
+Параметры запроса:
-Параметры запроса:
+#(string) token,
+#(int) controller_id
+<!--T:82-->
 Пример запроса:
 <pre>
 {
-	"token":"8yE-VIQrYuZ2bTeho_lajxjOJPnIe_Yx",
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"controller_id":"81"
+	"controller_id": 122
 }
 </pre>
-response:
+<!--T:83-->
-параметры ответа:
+Ответ:
-пример:
+<!--T:85-->
+Пример ответа:
 <pre>
 {
 	"error":null,
-	"data":{"resuls":"Ok"}
+	"data":{
+		"status":1
+		}
 }
 </pre>
+<!--T:86-->
+Поле “status” может принимать следующие значения:
+• 0 – офлайн
-= Список устройств пользователя (list) =
+<!--T:87-->
+• 1 – онлайн
-request:
+<!--T:88-->
-Request URL: [site]/api/device/list
+• 2 – онлайн, после включения питания
+== Получение конфигурации Контроллера (config) == <!--T:89-->
-параметры запроса: (int) controller_id , (string) token
+<!--T:82-->
+Запрос:
+Request URL: [site]/api/ctrl/config/
+<!--T:82-->
+Параметры запроса:
+#(string) token,
+#(int) controller_id
+<!--T:82-->
+Пример запроса:
-Пример запрса:
 <pre>
 {
-	"controller_id": 1 ,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"controller_id" : 111
 }
 </pre>
-response:
+<!--T:82-->
-параметры ответа:
+Ответ:
-Пример ответа:
+<!--T:82-->
+Пример ответа (data):
 <pre>
 {
-"0":{
+	"id":"1",   // id конфигурации
-	"id":"122",
+	"controller_id":"111",   // id контроллера
-	"external_id":"19", //id на контроллере
+	"language":"ru-RU",
-	"controller_id":"6",
+	"hostname":"alarm-system",
-	"name":"Сирена",
+	"wifi_mode":1,   // 1 - STA, 2 - AP
-	"type_id":"2",  //тип устройства
+	"wifi_sta_type":1, // 0 - STATIC, 1 - DHCP
-	"codes":":{     //коды (кнопки)
+	"wifi_sta_ssid":"SSID",
-		"0":{
+	"wifi_sta_pass":"PASSWORD",
-		"id":"218",
+	"wifi_sta_ip":"192.168.0.101",
-		"external_cod_id":"32",
+	"wifi_sta_mask":"255.255.255.0",
-		"device_id":"122",
+	"wifi_sta_gw":"192.168.0.1",
-		"name":"ON",
+	"wifi_sta_dns1":"208.67.222.222",
-		"code":"3675192",
+	"wifi_sta_dns2":"208.67.222.222",
-		"protocol":"1",
+	"wifi_ap_authmode": 3, // 0 - OPEN, 1 - WEP, 2 - WPA_PSK, 3 - WPA2_PSK, 4 - WPA_WPA2_PSK
-		"pulse_len":null,
+	"wifi_ap_hidden":0, // 0/1
-		"group_1":"1",
+	"wifi_ap_channel":1, // 1...14
-		"group_2":"0",
+	"wifi_ap_ssid":"SMARTHOME_000000000000",
-		"group_3":"0",
+	"wifi_ap_pass":"00000000",
-		"group_4":"0",
+	"wifi_ap_ip":"192.168.4.1",
-		"group_5":"0",
+	"wifi_ap_mask":"255.255.255.0",
-		"group_6":"0",
+	"wifi_ap_gw":"192.168.4.1",
-		"group_7":"0",
+	"httpd_port":80, // 1...65535
-		"group_8":"0",
+	"httpd_auth":0, // 0/1
-		"active":"1"
+	"httpd_user":"admin",
-		},
+	"httpd_pass":"admin",
-		"1":{ ... }
+	"ntp_enable":0, // 0/1
-	},
+	"ntp_host":"time.windows.com",
-	"state":"1",
+	"ntp_tz":3, // -11...13
-	"on_dashboard":"1", //показывать на главной
+	"upnp_enable":1, // 0/1
-	"active":"1"
+	"advanced_mode":0, // 0/1
-},
+	"app_afb_enable":1, // 0/1
-"1":{
+	"app_leds_off":1, // 0/1
-	"id":"120",
+	"app_alarm_duration":10, // minutes
-	"external_id":"22",
+	"app_arming_delay":0, // seconds
-	"controller_id":"6",
+	"app_portal_link":0, // 0/1
-	"name":"Пульт 4кн бел",
+	"app_rf_freq":2, // 1 - 315Mhz, 2 - 433Mhz
-	"type_id":"3",
+	"app_rf_power":3, // 0 - 1DBM, 1 - 2DBM, 2 - 5DBM, 3 - 8DBM, 4 - 11DBM, 5 - 14DBM, 6 - 17DBM, 7 - 20DBM
-	"codes": ... ,
+	"app_button_action":1, // 0 - NONE, 1 - ARMING, 2 - RUN_ACTION, 3 - SEND_CODE
-	"state":"1",
+	"app_button_rec_id":0, // ID
-	"on_dashboard":"0",
+	"gsm_pin":"1234",
-	"active":"1"
+	"gsm_allowed_phones":"", // список через запятую
+	"gsm_sendto_phones":"", // список через запятую
+	"gsm_callto_phones":"", // один номер
+	"gsm_smsin_enable":"0", // 0/1
+	"gsm_smsout_enable":"0", // 0/1
+	"gsm_call_enable":"0", // 0/1
+	"gprs_enable":"1", // 0/1
+	"gprs_apn":"", "internet.mts.ru",
+	"gprs_user":"mts",
+	"gprs_pass":"mts",
+	"gsm_enable":"0", // 0/1
+	"ebus_enable":0, // 0/1
+	"command":"xxx",
+	"response":"0"
+}
+</pre>
+== Изменение конфигурации контроллера(config-set) == <!--T:89-->
+<!--T:89-->
+Запрос:
+Request URL: [site]/api/ctrl/config-set/
+<!--T:89-->
+Параметры запроса:
+#(string) token,
+#(int) controller_id
+<!--T:89-->
+Пример запроса:
+<pre>
+{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"controller_id" : 111,
+	"command": "yyy"    // параметры контроллера смотри метод Получить конфигурацию контроллера(ctrl/config/)
+}
+</pre>
+<!--T:89-->
+Ответ:
+<!--T:89-->
+Пример ответа (data):
+<pre>
+{
+	"result": "Ok"
 }
-}
+</pre>
-</pre>
+==  Передача локального IP Контроллера (get-ip) == <!--T:89-->
-= Информация об устройстве (info) =
+Запрос
-request:
+<!--T:90-->
+Request URL: [site]/api/ctrl/get-ip
-Request URL: [site]/api/device/info/
+<!--T:91-->
+Request Params:
-параметры запроса:
+#token (required): string(64);
+#controller_id (required): int;
-(int) controller_id,
+Ответ:
+<!--T:94-->
-(int) device_id,
+Пример ответа:
-(string) token
+<!--T:95-->
-Пример запрса:
 <pre>
 {
-	"controller_id": 1 ,
+	data:'192.168.0.15',
-	"device_id": 122,
+	error: null
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+== Установка подписки на Контроллере == <!--T:96-->
+Запрос:
+<!--T:97-->
+Request URL: [site]/in/subscription/set”
+Ответ:
+Пример ответа (data):
-параметры ответа:
-Пример ответа:
 <pre>
 {
-	"id":"122",
+	"seq_id": 0,
-	"external_id":"19",
+	"id": 1, // ID подписки (см. ниже)
-	"controller_id":"6",
+	"remain_time": 100 // оставшееся время в секундах, 4294967295 - неограниченно
-	"name":"Сирена",
+}
-	"type_id":"2",
+</pre>
-	"codes":{
-		"0":{
+==  Просмотр статуса подписки (get-subscribe-status) == <!--T:98-->
-		"id":"218",
-		"external_cod_id":"32",
+Запрос:
-		"device_id":"122",
-		"name":"ON",
+<!--T:99-->
-		"code":"3675192",
+Request URL: [site]/api/ctrl/get-subscribe-status
-		"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"
-}
-</pre>
-= Нажатие кнопки на устройстве (event) =
+<!--T:100-->
+Параметры:
-request:
+<!--T:101-->
+#token (required): string(64)
+#controller_id (required): int
-Request URL: [site]/api/device/event/
+<!--T:103-->
-параметры запроса:
+Ответ:
-(string) controller_name,
+Пример ответа (data):
-(int) device_external_id,
+<!--T:104-->
+<pre>
-(int) cod_external_id,
+{
+	data:{
-(string) token,
+		id: 1,
+		controller_id: 40,
+		user_id: 424,
+		remain_time: 100,
+		request_time: 1355314332,
+		response_time: 1355315332,
+		success: 0
+	},
+	error: ''
+}
+</pre>
-(int) device_type
+==  Активация/продление/покупка подписки (set-subscribe) == <!--T:105-->
-Пример запроса:
+Запрос:
-<pre>
+<!--T:106-->
-{
+Request URL: [site]/api/ctrl/set-subscribe
-	"controller_name": " AS_7F26335CCF4B" ,
-	"device_external_id": 19,
-	"cod_external_id": 1,
-	"device_type": 1,
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
-}
-</pre>
-так как MQTT  односторонний - ответа быть не может. Может быть возвращён ответ, что запрос отправлен:
+<!--T:107-->
-response:
+Параметры:
-параметры ответа:
+<!--T:108-->
+#token (required): string(64)
+#controller_id (required): int
-Пример ответа:
+<!--T:110-->
+Ответ:
 <pre>
 {
-	"result": "Ok"
+	data:{
+		id: 1,
+		controller_id: 40,
+		user_id: 424,
+		remain_time: 100,
+		request_time: 1355314332,
+		response_time: 1355315332,
+		success: 0
+	},
+	error: ''
 }
 </pre>
+==  Метод получения списка телефонов (get-phones) == <!--T:111-->
-= Обновление информации об устройстве (update) =
+Запрос:
-request:
+<!--T:112-->
+Request URL: [site]/api/ctrl/get-phones
-Request URL: [site]/api/device/update/
+<!--T:113-->
+Параметры:
-параметры запроса:
+<!--T:114-->
+#token (required): string, 64
+#controller_id (required): int
+#type (optional): string,
+#range ['recipient', 'authorized', 'all'], (default: 'all')
-(int) device_id,
+<!--T:117-->
+Ответ:
-(string) name,
+Пример ответа:
-(int) active,
-(string) token,
-Пример запроса:
+<!--T:118-->
 <pre>
 {
-	"device_id": 107,   // local device id
+	'error': null,
-	"name": "New name", // new name
+	data: [
-	"active": 1,
+		{'id': 5, 'phone': '+380123456789'},
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+		{'id': 6, 'phone': '+380123334455'},
+		{'id': 7, 'phone': '+380112223344'}
+	]
 }
 </pre>
-response:
-параметры ответа:
+==  Редактирование телефона (edit-phone) == <!--T:119-->
-Пример ответа:
+Запрос:
+<!--T:120-->
+Request URL: [site]/api/ctrl/edit-phone
+<!--T:121-->
+Параметры:
+<!--T:122-->
+#token (required): string, 64
+#phone_id (required): int
+#is_recipient (optional): int
+#is_authorized (optional): int
+#phone (optional): string
+<!--T:127-->
+Ответ:
+Пример ответа:
 <pre>
 {
-	"resuls" : "Ok"
+	"error":null,
+	"data":{
+		"id":2,
+		"controller_id":81,
+		"phone":"+380503334455",
+		"is_recipient":"1",
+		"is_authorized":0
+	}
 }
 </pre>
-= Удаление устройства (delete) =
-request:
+==  Удаление телефона (delete-phone) == <!--T:128-->
+Запрос:
+<!--T:129-->
+Request URL: [site]/api/ctrl/delete-phone
-Request URL: [site]/api/device/delete/
+<!--T:130-->
+Параметры:
-параметры запроса:
+<!--T:131-->
+#token (required): string, 64
+#phone_id (required): int
-(int) device_id,
+<!--T:133-->
+Ответ:
-(string) token
+Пример ответа:
-Пример запроса:
 <pre>
 {
-	"device_id": 107,   // local device id
+	"error":null,
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"data":{"response":"OK"}
 }
 </pre>
-response:
+== Добавление телефона (add-phone) == <!--T:134-->
-Параметры ответа:
+Запрос:
-Пример ответа:
+<!--T:135-->
+Request URL: [site]/api/ctrl/add-phone
+<!--T:136-->
+Params:
+<!--T:137-->
+#token (required): string, 64
+#controller_id (required): int
+#phone (required): string
+#is_recipient (optional): int
+#is_authorized (optional): int
+<!--T:142-->
+Ответ:
+Пример ответа:
+<!--T:143-->
 <pre>
 {
-	"resuls" : "Ok"
+	"error":null,
+	"data":{
+		"id":2,
+		"controller_id":81,
+		"phone":"+380503334455",
+		"is_recipient":"1",
+		"is_authorized":0
+	}
 }
 </pre>
+== Информация о версии прошивки контроллера (fw-version-current) == <!--T:145-->
-Код:
+Запрос:
+Request URL: [site]/api/ctrl/fw-version-current/
-= Список действий (list) =
+Параметры запроса:
+#(int) controller_id,
+#(string) token
-request:
+Пример запроса:
-Request URL: [site]/api/scheduler/list/
-параметры запроса: (string) token
-Пример запроса:
 <pre>
 {
+	"controller_id": 1 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+Ответ:
-параметры ответа:
+Пример ответа (data):
-Пример ответа:
 <pre>
 {
-"0":{
+	"version_id":1,
-	"id":9,
+	"version_name":"0.01",
-	"external_id":42,
+	"tag":"OLD",
-	"name":"test_form_web",
+	"url":"\/controllers_fw\/NULL.bin",
-	"operation":"local",
+	"date":"16.10.2018",
-	"armed":0,
+	"new_version_id":38   // если "new_version_id" != "version_id" значит имеется новая версия.
-	"type":"meteo",
+}
-	"action_id":1,
+</pre>
-	"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
-	...
-	}
-}
-</pre>
+== Информация о последней версии прошивки контроллера (get-new-fw-version) == <!--T:145-->
-= Обновление действий (update) =
+Запрос:
-Запрос осуществляется в 2 этапа: на первом этапе происходит при запросе на обновление Контроллера (см. "Обновление Контроллера");
+Request URL: [site]/api/ctrl/get-new-fw-version/
-на втором этапе обновляется информация о каждом действии.
-request:
+Параметры запроса:
-Request URL: [site]/api/scheduler/update/
-параметры запроса:
+#(int) controller_id,
+#(string) token
-(int) controller_id,
+<pre>
+Пример запроса:
-(string) token
-Пример запроса:
-<pre>
 {
-	"controller_id": 6 ,
+	"controller_id": 1 ,
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
+Ответ:
-параметры ответа:
+Пример ответа (data):
-Пример ответа:
 <pre>
 {
-	"result": "Ok" // ответ что запрос ушел
+	"version_id":38,
+	"version_name":"0.14",
+	"tag":"0.14 \/ Oct 5 2018 16:49:04",
+	"url":"\/controllers_fw\/tls-smarthome-hw-9_0.14.bin",
+	"date":"16.10.2018"
 }
 </pre>
-Процесс обновления происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (Контроллер, действия)
+= Устройства = <!--T:144-->
-= Информация о действии (info) =
+== Получение списка устройств пользователя (list) == <!--T:145-->
-request:
+<!--T:146-->
-Request URL: [site]/api/scheduler/info/
+Запрос:
-параметры запроса:
+<!--T:147-->
+Request URL: [site]/api/device/list
-(int) scheduler_id,
+<!--T:148-->
+Параметры запроса:
-(string) token
+#(int) controller_id,
+#(string) token
-Пример ответа:
+<!--T:149-->
+Пример запроса:
 <pre>
 {
-	"scheduler_id": 122,
+	"controller_id": 1 ,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
-параметры ответа:
+<!--T:150-->
+Ответ:
-Пример ответа:
+Пример ответа (data):
 <pre>
 {
-	"id":9,
+"0":{
-	"external_id":42,
+	"id":"122",
-	"name":"test_form_web",
+	"external_id":"19", //id на контроллере
-	"operation":"local",
+	"controller_id":"6",
-	"armed":0,
+	"name":"Сирена",
-	"type":"meteo",
+	"type_id":"2",  //тип устройства
-	"action_id":1,
+	"codes":":{     //коды (кнопки)
-	"a_controller_id":6,
+		"0":{
-	"a_device_id":112,
+		"id":"218",
-	"a_code_id":0,
+		"external_cod_id":"32",
-	"a_device_external_id":38,
+		"device_id":"122",
-	"a_armed":0,
+		"name":"ON",
-	"a_conf1":0,
+		"code":"3675192",
-	"a_conf2":0,
+		"protocol":"1",
-	"a_conf3":0,
+		"pulse_len":null,
-	"a_conf4":0,
+		"group_1":"1",
-	"a_conf5":0,
+		"group_2":"0",
-	"a_conf6":0,
+		"group_3":"0",
-	"a_conf7":0,
+		"group_4":"0",
-	"a_conf8":0,
+		"group_5":"0",
-	"target_id":1,
+		"group_6":"0",
-	"t_controller_id":6,
+		"group_7":"0",
-	"t_device_id":119,
+		"group_8":"0",
-	"t_code_id":203,
+		"active":"1"
-	"t_device_external_id":7,
+		},
-	"t_armed":0,
+		"1":{ ... }
-	"t_conf1":0,
+	},
-	"t_conf2":0,
+	"state":"1",
-	"t_conf3":0,
+	"on_dashboard":"1", //показывать на главной
-	"t_conf4":0,
+	"active":"1"
-	"t_conf5":0,
+},
-	"t_conf6":0,
+"1":{
-	"t_conf7":0,
+	"id":"120",
-	"t_conf8":0,
+	"external_id":"22",
-	"date":null,
+	"controller_id":"6",
-	"repetition":"0",
+	"name":"Пульт 4кн бел",
-	"sensor_type":"1",
+	"type_id":"3",
-	"logic_operation":"=",
+	"codes": ... ,
-	"value":"3",
+	"state":"1",
-	"active":1
+	"on_dashboard":"0",
-}
+	"active":"1"
-</pre>
+	}
+}
-=== (create) ===
-request:
-Request URL: [site]/api/
-параметры запроса:
-пример:
-<pre>
-{
-}
-</pre>
-response:
-параметры ответа:
-пример:
-<pre>
-{
-}
-</pre>
-=== (update) ===
-request:
-Request URL: [site]/api/
-параметры запроса:
-пример:
-<pre>
-{
-}
 </pre>
-response:
-параметры ответа:
-пример:
-<pre>
-{
-}
+== Информация об устройстве (info) == <!--T:151-->
-</pre>
-=== (delete)===
+<!--T:152-->
-request:
+Запрос:
-Request URL: [site]/api/login
-параметры запроса:
-пример:
-<pre>
-{
-}
-</pre>
-response:
+<!--T:153-->
-параметры ответа:
+Request URL: [site]/api/device/info/
-пример:
-<pre>
+<!--T:154-->
-{
+Параметры запроса:
-}
+<!--T:155-->
-</pre>
+#(int) controller_id,
+#(int) device_id,
-= Логи пользователя (logs) =
+#(string) token
-request:
-Request URL: [site]/api/profile/logs/
-параметры запроса: (string) token
+<!--T:158-->
 Пример запроса:
 <pre>
 {
+	"controller_id": 1 ,
+	"device_id": 122,
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
-response:
-параметры ответа: (object)
-пример:
-{
-}
-________________________________________
+<!--T:159-->
+Ответ:
-= Получение метеоданных (last) =
+Пример ответа (data):
-request:
-Request URL: [site]/api/device/meteo-last/
-параметры запроса:
-(string) token,
-(int) device_id
-Пример запроса:
 <pre>
 {
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"id":"122",
-	"device_id": 130
+	"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",
+	"alias":"xxx",
+	"send_sms ":0,
+	"voice_call":0,
+	place"
+		"name":null,
+		"color":null
+		}
 }
 </pre>
-response:
-параметры ответа: (object)
+== Обновление информации об устройстве (update) == <!--T:161-->
+<!--T:162-->
+Запрос:
+<!--T:163-->
+Request URL: [site]/api/device/update/
+<!--T:164-->
+Параметры запроса:
-Пример ответа:
+<!--T:165-->
+#(int) device_id,
+#(string) name,
+#(int) active,
+#(string) token,
+<!--T:169-->
+Пример запроса (data):
 <pre>
 {
-	"id":"4046",
+	"device_id": 107,   // local device id
-	"controller_name":"AS_7FD6785CCF5D",
+	"name": "New name", // new name
-	"internal_id":"55",
+	"active": 1,
-	"device_id":"130",
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
-	"name":"7",
-	"temp":"240",
-	"hum":"245",
-	"illum":"0",
-	"pres":"1239",
-	"volt":"32",
-	"date_time":"2016-03-02 21:09:40",
-	"new":"0"
 }
 </pre>
-= Получение метеоданных за период (period) =
+Ответ:
-request:
+Пример ответа (data):
+<pre>
+{
+	"result" : "Ok"
+}
+</pre>
-Request URL: [site]/api/device/meteo-period/
+== Удаление устройства (delete) == <!--T:171-->
-параметры запроса:
+<!--T:172-->
+Запрос:
-(string) token,
+<!--T:173-->
+Request URL: [site]/api/device/delete/
-(int) device_id,
+<!--T:174-->
+Параметры запроса:
-(int) period
+<!--T:175-->
+#(int) device_id,
+#(string) token
+<!--T:177-->
 Пример запроса:
 <pre>
 {
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"device_id": 107,   // local device id
-	"device_id": 130,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
-	"period": 1 // количество дней
 }
 </pre>
-response:
+<!--T:178-->
+Ответ:
-параметры ответа: (array to objects)
+<!--T:180-->
+Пример ответа (data):
-Пример ответа:
 <pre>
-[
+{
-	{
+	"result" : "Ok"
-	"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
-	...
-	},
-]
 </pre>
-= Получение данных электропитания (last) =
+== Получение метеоданных (last) == <!--T:182-->
-request:
+<!--T:183-->
-Request URL: [site]/api/device/electro-last/
+Запрос:
-параметры запроса:
+Request URL: [site]/api/device/meteo-last/
-(string) token,
+<!--T:184-->
+Параметры запроса:
-(int) device_id
+<!--T:185-->
+#(string) token,
+#(int) device_id
+<!--T:187-->
 Пример запроса:
 <pre>
 {
@@ Строка 1045: / Строка 1208: @@
 </pre>
-response:
+Ответ:
-параметры ответа: (object)
+<!--T:189-->
+Пример ответа (data):
-Пример ответа:
+<!--T:190-->
+<pre>
+{
+	"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"
+}
+</pre>
+== Получение метеоданных за период (period) == <!--T:191-->
+Запрос:
+<!--T:192-->
+Request URL: [site]/api/device/meteo-period/
+<!--T:193-->
+Параметры запроса:
+<!--T:194-->
+#(string) token,
+(int) device_id,
+#(int) period
+<!--T:197-->
+Пример запроса:
 <pre>
 {
-	"id":"318",
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"controller_id":"11",
+	"device_id": 130,
-	"external_id":"2",
+	"period": 1 // количество дней
-	"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"
 }
 </pre>
-= Получение данных электропитания за период (period) =
+<!--T:198-->
+Ответ:
-request:
-Request URL: [site]/api/device/electro-period/
-параметры запроса:
-(string) token,
-(int) device_id,
+<!--T:199-->
+параметры ответа (array to objects):
-(int) period
+<!--T:200-->
+Пример ответа (data):
-Пример запроса:
 <pre>
-{
+[
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	{
-	"device_id": 130,
+	"id":"4065",
-	"period": 1 // количество дней
+	"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
+	...
+	},
+]
 </pre>
-response:
-параметры ответа: (array to objects)
+== Получение данных электропитания (last) == <!--T:201-->
+Запрос:
+Request URL: [site]/api/device/electro-last/
+<!--T:202-->
+Параметры запроса:
+<!--T:203-->
+#(string) token,
+#(int) device_id
-Пример ответа:
+<!--T:205-->
+Пример запроса:
 <pre>
-[
+{
-	{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"device_id": 130
+}
+</pre>
+<!--T:206-->
+Ответ:
+<!--T:208-->
+Пример ответа (data):
+<!--T:209-->
+<pre>
+{
 	"id":"318",
 	"controller_id":"11",
@@ Строка 1117: / Строка 1337: @@
 	"date_create":"2017-07-21 01:20:33",
 	"new":"0"
-	},
+}
-	{
+</pre>
-	"id":"318",
-	"controller_id":"11",
-	...
-	},
-]
-</pre>
-= ?? Получение данных о сторонних устройствах (other-last) =
+== Получение данных электропитания за период (period) == <!--T:210-->
-Метод возвращает информацию о последнем обнаруженном стороннем устройстве.
-request:
+Запрос:
-Request URL: [site]/api/device/other-last/
+<!--T:211-->
+Request URL: [site]/api/device/electro-period/
+<!--T:212-->
 Параметры запроса:
-(string) token,
+<!--T:213-->
+#(string) token,
+#(int) device_id,
+#(int) period
-(int) device_id
+<!--T:216-->
+Пример запроса:
-Пример запроса:
 <pre>
 {
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"device_id": 118
+	"device_id": 130,
+	"period": 1 // количество дней
 }
 </pre>
-response:
-параметры ответа: (object)
+Ответ:
+<!--T:217-->
+Параметры ответа: (array to objects)
-Пример ответа:
+<!--T:218-->
+Пример ответа (data):
 <pre>
-{
+[
-	"id":"1301",
+	{
-	"controller_id":"6",
+	"id":"318",
-	"device_id":"118",
+	"controller_id":"11",
-	"name":"Розетка",
+	"external_id":"2",
-	"code":"81",
+	"device_id":"125",
-	"pulse_len":null,
+	"name":"23",
-	"bit_len":null,
+	"token":"747D3844ABD35B08F27D18D15D7178B7AF99A754D805633928D4362D19B4AEC2",
-	"protocol":null,
+	"last_seen":"2017-07-21 04:20:27",
-	"groups":null,
+	"available":"1",
-	"type":null,
+	"voltage":"24",
-	"date_time":"2017-08-21 04:55:18",
+	"have_voltage":"1",
-	"active":null,
+	"current":"2147483647",
-	"new":"1"
+	"have_current":"1",
-}
+	"supp_voltage":"33",
+	"date_create":"2017-07-21 01:20:33",
+	"new":"0"
+	},
+	{
+	"id":"318",
+	"controller_id":"11",
+	...
+	},
+]
 </pre>
+== Получение данных о сторонних устройствах (other-last) == <!--T:219-->
-=?? (period) =
+<!--T:220-->
-request:
+Метод возвращает информацию о последнем обнаруженном стороннем устройстве.
+Запрос:
-Request URL: [site]/api/device/other-period/
+<!--T:221-->
+Request URL: [site]/api/device/other-last/
-параметры запроса:
+<!--T:222-->
+Параметры запроса:
-(string) token,
+<!--T:223-->
+#(string) token,
+#(int) device_id
-(int) device_id,
+<!--T:225-->
+Пример запроса:
-(int) period
+<pre>
-Пример запроса:
 {
 	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"device_id": 118,
+	"device_id": 118
-	"period": 1 // количество дней
 }
-response:
+</pre>
-параметры ответа: (array to objects)
+Ответ:
-Пример ответа:
+<!--T:227-->
+Пример ответа (data):
 <pre>
 {
@@ Строка 1210: / Строка 1447: @@
 	"active":null,
 	"new":"1"
-	},
-	{
-	"id":"4067",
-	"controller_id":"6",
-	...
 }
 </pre>
-________________________________________
-=== Ошибки: ===
-параметры ошибки:
+== Получение данных о сторонних устройствах за период (other-period) == <!--T:228-->
-пример:
-<pre>
+Запрос:
-{
-	"errors":{
-		"password": [
-			"Incorrect username."
-		]
-	}
-}
-</pre>
-= Получение списка иконок мест (places) =
+<!--T:229-->
+Request URL: [site]/api/device/other-period/
-Request URL: [site]/api/places/get-icons
+<!--T:230-->
+Параметры запроса:
-Пример ответа:
+<!--T:231-->
-<pre>
+#(string) token,
-{
+#(int) device_id,
-	"error":null,
+#(int) period
-	"data":{"home":"Home","industry":"Factory","calculator":"Office","shopping-cart":"Market","cubes":"Warehouse","beer":"Bar","building":"Room","flask":"Laboratory","wrench":"Workshop","bell":"Living room","coffee":"Kitchen","car":"Garage","tree":"Outside"}
-}
+<!--T:234-->
+Пример запроса:
-= Получение списка созданных мест (index) =
+<pre>
-Request URL: [site]/api/places/index
-Request params:
-token (required): string, 64
-Response:
-<pre>
 {
-	"error":null,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"data":{
+	"device_id": 118,
-		"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}]
+	"period": 1 // количество дней
-		}
 }
 </pre>
+Ответ:
-= Создание места (create) =
+<!--T:236-->
+Пример ответа (data):
-Request URL: [site]/api/places/create
+<pre>
+{
-Request params:
+	"id":"1301",
+	"controller_id":"6",
-token (required): string, 64
+	"device_id":"118",
+	"name":"Розетка",
-root (optional): int, default 1
+	"code":"81",
+	"pulse_len":null,
-lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
+	"bit_len":null,
+	"protocol":null,
-rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
+	"groups":null,
+	"type":null,
-lvl (optional): int, default 0
+	"date_time":"2017-08-21 04:55:18",
+	"active":null,
+	"new":"1"
+	},
+	{
+	"id":"4067",
+	"controller_id":"6",
+	...
+}
+</pre>
-name (optional): string, 64, default 'Simple name'
+= Wizard добавления устройств  = <!--T:237-->
-icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
-color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
+== Датчик открытия двери (create-door-open-sensor) == <!--T:238-->
-active (optional): int, default 1
+Запрос:
-selected (optional): int, default 0
+<!--T:239-->
+URL:  [site]/api/wizard/create-door-open-sensor
-disabled (optional): int, default 0
+<!--T:240-->
+Параметры запроса:
-readonly (optional): int, default 0
+#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 //Название кода садящейся батареи
-visible (optional): int, default 1
+<!--T:241-->
+Ответ:
-collapsed (optional): int, default 0
+Пример ответа:
+<pre>
+{
+	data:{
+		'response': 'OK'
+		},
+	error: null
+}
+</pre>
-movable_u (optional): int, default 1
+<!--T:242-->
+После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
-movable_d (optional): int, default 1
+==  Датчик затопления (create-flood-sensor) == <!--T:243-->
-movable_l (optional): int, default 1
+Запрос:
-movable_r (optional): int, default 1
+<!--T:244-->
+Request URL: [site]/api/wizard/create-flood-sensor
-removable (optional): int, default 1
+<!--T:245-->
+Параметры запроса:
-removable_all (optional): int, default 0
+<!--T:246-->
+#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 //Название кода садящейся батареи
-inverse_text (optional): string, default 'black'
+<!--T:251-->
+Ответ:
+Пример ответа:
-Response:
 <pre>
 {
-	error:null,
+	data: {
-	data: {'message': 'OK'}
+		'response': 'OK'
+		},
+	error: null
 }
 </pre>
+После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
-=  Редактирование места (edit) =
-Request URL: [site]/api/places/edit
+== Пульт,4 кнопки (create-console) == <!--T:252-->
-Request params:
+Запрос:
-token (required): string, 64
+<!--T:253-->
+Request URL: [site]/api/wizard/create-console
-place_id (required): int
+<!--T:254-->
+Параметры запроса:
-root (optional): int, default 1
+<!--T:255-->
+#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 //Название кода оповещения
-lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
+<!--T:262-->
+Ответ:
-rgt (optional): int, from 1 to 5 //В сумме с lft должно быть 5
+Пример ответа:
-lvl (optional): int, default 0
+<pre>
+{
+	data: {
+		'response': 'OK'
+	},
+	error: null
+}
+</pre>
-name (optional): string, 64, default 'Simple name'
+После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
-icon (optional): string, default '' //Допускаемые параметры -- ключи объекта выше
-color (optional): string, default: '#ccc' //Любой цвет в формате HEX, решетка в начале обязательна
+== Сирена (create-siren) == <!--T:263-->
-active (optional): int, default 1
+Запрос:
-selected (optional): int, default 0
+<!--T:264-->
+Request URL: [site]/api/wizard/create-siren
-disabled (optional): int, default 0
+<!--T:265-->
+Параметры запроса:
-readonly (optional): int, default 0
+<!--T:266-->
+#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
-visible (optional): int, default 1
+<!--T:272-->
+Ответ:
-collapsed (optional): int, default 0
+Пример ответа:
-movable_u (optional): int, default 1
+<pre>
+{
-movable_d (optional): int, default 1
+	data: {
+		'response': 'OK'
+		},
+	error: null
+}
+</pre>
-movable_l (optional): int, default 1
+Перед отправкой параметров необходимо перевести сирену в режим обучения.
-movable_r (optional): int, default 1
-removable (optional): int, default 1
+== Метеостанция: получение списка обнаруженных метеостанций за последние 10 минут (get-meteos) == <!--T:273-->
-removable_all (optional): int, default 0
+Запрос:
-inverse_text (optional): string, default 'black'
+Request URL: [site]/api/wizard/get-meteos
+<!--T:274-->
+Параметры запроса:
-Response:
+<!--T:275-->
-<pre>
+#controller_id (required): int
-{
+#token (required): string, 64
-	error:null,
-	data: {'message': 'OK'}
-}
-</pre>
-= Удаление места (delete) =
+<!--T:277-->
+Ответ:
-Request URL: [site]/api/places/delete
+Пример ответа:
-Request params:
-token (required): string, 64
-place_id (required): int
-Response:
 <pre>
 {
-	error:null,
+	"error":null,
-	data: {'message': 'OK'}
+	"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"
+			}
+		]
 }
 </pre>
-= Обновление статуса контроллера (update-status) =
+== Метеостанция: добавление (create-meteo) == <!--T:278-->
-request:
+Запрос:
-Request URL: [site]/api/ ctrl/update-status/
+<!--T:279-->
+Request URL: [site][site]/api/wizard/create-meteo
+<!--T:280-->
 Параметры запроса:
-(string) token,
+<!--T:281-->
+#controller_id (required): int
+#token (required): string, 64
+#meteo_num (required): int //Получается в списке выше
+#device_name (optional): string, 256
-(int) controller_id
+<!--T:285-->
+Ответ:
-Пример запроса:
-<pre>
-{
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"controller_id": 122
-}
-</pre>
-response:
-параметры ответа:
 Пример ответа:
 <pre>
 {
 	"error":null,
 	"data":{
-		"resuls":"Ok"
+		"response":"OK"
 		}
 }
 </pre>
-= Получение актуального статуса Контроллера (get-status) =
+== Водопроводный кран == <!--T:286-->
-request:
-Request URL: [site]/api/ ctrl/get-status/
+<!--T:287-->
+Порядок добавления крана:
-параметры запроса:
+) Сгенерировать коды
-(string) token,
+<!--T:288-->
+) Зажать на кране кнопку, пока кран не мигнёт трижды
-(int) controller_id
+<!--T:289-->
+) Отправить один код
-Пример запроса:
+<!--T:290-->
-<pre>
+) Нажать на кране кнопку однократно
-{
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"controller_id": 122
-}
-</pre>
-response:
+<!--T:291-->
+) Зажать на кране кнопку, пока не мигнёт 4 раза
-параметры ответа:
+<!--T:292-->
+) Отправить второй код из сгенерированных
+<!--T:293-->
+) Нажать на кране кнопку однократно
+<!--T:294-->
+) Отправить запрос на создание крана.
+=== Генерация кодов === <!--T:295-->
+Запрос:
+<!--T:296-->
+Request URL: [site]/api/wizard/create-codes
+<!--T:297-->
+Параметры запроса:
+<!--T:298-->
+#controller_id (required): int
+#token (required): string, 64
+<!--T:300-->
+Ответ:
 Пример ответа:
 <pre>
 {
 	"error":null,
-	"data":{
+	"data":
-		"status":1
+		{
+			"response":{
+					"id":30,
+					"masks":"[6,4,0,1]",
+					"code_1":"9920950",
+					"code_2":"9920948",
+					"code_3":"9920944",
+					"code_4":"9920945"
+				}
 		}
 }
 </pre>
-Поле “status” может принимать следующие значения:
-• 0 – офлайн
-• 1 – онлайн
-• 2 – онлайн, после включения питания
-= Добавление устройств через wizard =
+=== Выполнение кода === <!--T:301-->
+Запрос:
-== Датчик открытия двери (create-door-open-sensor) ==
+<!--T:302-->
+Request URL: [site]/api/wizard/execute-code
-URL:  [site]/api/wizard/create-door-open-sensor
+<!--T:303-->
+Параметры запроса:
+<!--T:304-->
+#controller_id (required): int
+#token (required): string, 64
+#code (required): int // Берется из сгенерированных
+<!--T:307-->
+Ответ:
-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:
 <pre>
 {
-	data:{
+	error: null,
-		'response': 'OK'
+	data: {
-		},
+		"response":"OK"
-	error: null
+		}
 }
 </pre>
-После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
+=== Добавление крана === <!--T:308-->
+Запрос:
-==  Датчик затопления (create-flood-sensor) ==
+<!--T:309-->
+Request URL: [site]/api/wizard/create-crane-by-codes
-Request URL: [site]/api/wizard/create-flood-sensor
+<!--T:310-->
+Параметры запроса:
-Params:
+<!--T:311-->
+#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 //Название кода закрытия
-controller_id (required): int
+<!--T:318-->
+Ответ:
-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:
 <pre>
 {
-	data: {
+	data:{'response': 'OK'},
-		'response': 'OK'
-		},
 	error: null
 }
 </pre>
----------------------------------------
-После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
+== Добавление розетки == <!--T:319-->
-== Пульт,4 кнопки (create-console) ==
+<!--T:320-->
+Порядок добавления розетки следующий:
-Request URL: [site]/api/wizard/create-console
+<!--T:321-->
+) Сгенерировать коды
-Params:
+<!--T:322-->
+) Зажать на розетке кнопку, пока она не начнет мигать
-controller_id (required): int
+<!--T:323-->
+) Отправить один код
-token (required): string, 64
+<!--T:324-->
+) Зажать на розетке кнопку, пока она не начнет мигать
-device_name (optional): string, 256
+<!--T:325-->
+) Отправить второй код из сгенерированых
-code_lock (optional): string, 64 //Название кода блокировки
+<!--T:326-->
+) Отправить запрос на создание розетки
-code_unlock (optional): string, 64 //Название кода разблокировки
-code_s (optional): string, 64 //Название кода s
+=== Генерация кодов (create-codes) === <!--T:327-->
-code_alarm (optional): string, 64 //Название кода оповещения
+Запрос:
+<!--T:328-->
+Request URL: [site]/api/wizard/create-codes
+<!--T:329-->
+Параметры запроса:
+<!--T:330-->
+#controller_id (required): int
+#token (required): string, 64
+#socket (required): любое значение.
+<!--T:333-->
+Ответ:
+Пример ответа:
-RESPONSE:
 <pre>
 {
-	data: {
+	"error":null,
-		'response': 'OK'
+	"data":{
-	},
+		"response":{"id":30,"masks":"[257, 258]","code_1":"8737025","code_2":"8737026"}
-	error: null
+		}
 }
 </pre>
----------------------------------------
-После отправки параметров ожидается срабатывание добавляемого устройства. При срабатывании происходит процесс добавления, и лишь после этого приходит ответ.
+=== Выполнение кода  (execute-code) === <!--T:334-->
-== Сирена (create-siren) ==
+Запрос:
-Request URL: [site]/api/wizard/create-siren
+<!--T:335-->
+Request URL: [site]/api/wizard/execute-code
-Params:
+<!--T:336-->
+Параметры запроса:
-controller_id (required): int
+<!--T:337-->
+#controller_id (required): int
+#token (required): string, 64
+#code (required): int // Берется из сгенерированных
-token (required): string, 64
+<!--T:340-->
+Ответ:
-device_name (optional): string, 256
+Пример ответа:
+<pre>
+{
+	error: null,
+	data: {'response' => 'OK'}
+}
+</pre>
-code_on (optional): string, 64 //Название кода включения
-code_off (optional): string, 64 //Название кода выключения
+=== Добавление розетки (create-socket) === <!--T:341-->
-code_blank (optional): string, 64 //Название кода blank
+Запрос:
-RESPONSE:
+<!--T:342-->
+Request URL: [site]/api/wizard/create-socket
+<!--T:343-->
+Параметры запроса:
+<!--T:344-->
+#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 //Название кода закрытия
+<!--T:351-->
+Ответ:
+Пример ответа:
 <pre>
 {
-	data: {
+	data: {'response':'OK'},
-		'response': 'OK'
-		},
 	error: null
 }
 </pre>
----------------------------------------
-Перед отправкой параметров необходимо перевести сирену в режим обучения.
+= Сценарии = <!--T:352-->
-== Метеостанция: получение списка обнаруженных метеостанций за последние 10 минут (get-meteos) ==
+== Получение списка сценариев (list) == <!--T:353-->
-Request URL: [site]/api/wizard/get-meteos
-Params:
+<!--T:354-->
+Запрос:
-controller_id (required): int
+Request URL: [site]/api/scheduler/list/
-token (required): string, 64
+<!--T:355-->
+Параметры запроса: (string) token
-RESPONSE:
+<!--T:356-->
+Пример запроса:
 <pre>
 {
-	"error":null,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
-	"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"}]
 }
 </pre>
-== Метеостанция: добавление (create-meteo) ==
+<!--T:357-->
+Ответ:
-Request URL: [site][site]/api/wizard/create-meteo
+<!--T:359-->
+Пример ответа:
-Params:
+<pre>
-controller_id (required): int
+{
+"error":null,
+"data"
+	"schedulers":[
+	{
+		"id":83,
+		"external_id":23,
+		"name":"Test 444",
+		"operation":"local",
+		"armed":2,
+		"type":"meteo",
+		"active":0,
+		"action"
+			"action_id":1,
+			"controller_id":109,
+			"device_id":1747,
+			"code_id":1100,
+			"device_external_id":64,
+			"armed":1,
+			"groups":7,
+			"sensor_type":"1",
+			"date":"00:00",
+			"repetition":"1",
+			"logic_operation":"=",
+			"value":"9"
+		},
+		"target"
+			"target_id":2,
+			"controller_id":109,
+			"device_id":0,
+			"device_external_id":0,
+			"code_id":0,
+			"external_cod_id":0,
+			"armed":0,
+			"groups":168
+		}
+		},
+		{
+		"id":84,
+		"external_id":24,
+		...
+		}]
+	}
+}
-token (required): string, 64
+<!--T:360-->
+</pre>
+== Обновление/добавление сценариев (update) == <!--T:361-->
+<!--T:362-->
+Запрос осуществляется в 2 этапа: на первом этапе происходит при запросе на обновление Контроллера (см. "Обновление Контроллера");
+на втором этапе обновляется информация о каждом действии.
+<!--T:363-->
+Запрос:
+Request URL: [site]/api/scheduler/update/
-meteo_num (required): int //Получается в списке выше
+<!--T:364-->
+Параметры запроса:
-device_name (optional): string, 256
+<!--T:365-->
+#(int) controller_id,
+#(string) token
-RESPONSE:
+Пример запроса:
 <pre>
 {
-	"error":null,
+	"controller_id": 6 ,
-	"data":{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-		"response":"OK"
-		}
 }
 </pre>
+<!--T:368-->
+Ответ:
+<!--T:370-->
+Пример ответа:
+<pre>
+{
+	"result": "Ok" // ответ что запрос ушел
+}
+</pre>
-== Водопроводный кран ==
+Процесс обновления происходит автоматически. Для получения результата требуется таймаут, после чего делается стандартный запрос на получение данных (Контроллер, действия)
-Порядок добавления крана:
-) Сгенерировать коды
-) Зажать на кране кнопку, пока кран не мигнёт трижды
-) Отправить один код
-) Нажать на кране кнопку однократно
-) Зажать на кране кнопку, пока не мигнёт 4 раза
-) Отправить второй код из сгенерированных
-) Нажать на кране кнопку однократно
-) Отправить запрос на создание крана.
-=== Генерация кодов ===
+== Информация о сценарии (info) == <!--T:371-->
-Request URL: [site]/api/wizard/create-codes
+<!--T:372-->
+Запрос:
-Params:
+Request URL: [site]/api/scheduler/info/
-controller_id (required): int
+<!--T:373-->
+Параметры запроса:
-token (required): string, 64
+<!--T:374-->
+#(int) scheduler_id,
+#(string) token
-Response:
+<!--T:376-->
+Пример запроса:
 <pre>
 {
-	"error":null,
+	"scheduler_id": 122,
-	"data":{"response":{"id":30,"masks":"[6,4,0,1]","code_1":"9920950","code_2":"9920948","code_3":"9920944","code_4":"9920945"}
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
-		}
 }
 </pre>
+Ответ:
-=== Выполнение кода ===
+<!--T:378-->
+Пример ответа (data):
-Request URL: [site]/api/wizard/execute-code
-Params:
-controller_id (required): int
-token (required): string, 64
-code (required): int // Берется из сгенерированных
-Response:
 <pre>
 {
-	error: null,
+"id":107,
-	data: {
+"external_id":6,
-		"response":"OK"
+"name":"Test 1.1.1",
-		}
+"operation":"local",
+"armed":1,
+"type":"device",
+"active":1,
+"action":{
+	"action_id":1,
+	"controller_id":111,
+	"device_id":1824,
+	"code_id":1399,
+	"device_external_id":18,
+	"armed":0,
+	"groups":0,
+	"sensor_type":"0",
+	"date":null,
+	"repetition":"0",
+	"logic_operation":"=",
+	"value":null
+},
+"targets":[
+		{
+		"id":87,
+		"type_id":3,
+		"controller_id":111,
+		"device_id":0,
+		"code_id":0,
+		"device_external_id":0,
+		"armed":1,
+		"groups":0
+		},
+		{
+		"id":88,
+		"type_id":1,
+		"controller_id":113,
+		"device_id":13,
+		"code_id":123,
+		"device_external_id":1234,
+		"armed":0,
+		"groups":0
+		},
+	]
 }
 </pre>
-=== Добавление крана ===
-Request URL: [site]/api/wizard/create-crane-by-codes
-Params:
+== Обновление сценариев (update) == <!--T:371-->
-controller_id (required): int
+Обновление состоит из двух запросов: 1) обновление действия, вызывающего событие; 2) обновления целей сработки.
+При этом запросы можно делать независимо друг от друга.
-token (required): string, 64
+=== Обновление/добавление действий и событий сценария (Update-action) ===
-code_1 (required): int
+Request URL: [site]/api/scheduler/update-action/
-code_2 (required): int
+Параметры запроса:
-device_name (optional): string, 256
+#(int) scheduler_id,
+#(string) token,
+#(string) name,
+#(int) "active"
+#(int) "send_sms"  // 1 - отправлять / 0 - не отправлять
+#(int) "make_call"   // 1 - отправлять / 0 - не отправлять
+#(int) "armed"  // 0 - в любом режиме, 1 - в режиме охраны, 2 - без режима охраны
+#(int) "action_id",
+#(int) "action_device_id",
+#(int) "action_code_id",
+#(int) "action_armed",
+#(int) "action_groups",   // битовая маска группы от 1 до 8
+#(string) "action_repetition",   // только для расписания: номер дней повторения через запятую от 1 до 7
+#(string) "action_event_time",    // только для расписания: время повторения
+#(int) "action_sensor_type",  // только для метео устройств: 1 - напряжение, 2 - температура, 3 - влажность, 4 - Атм. давление, 5 - Освещенность , 0 - не выбрано
+#(string) "action_logic_operation",   // логическая операция : '=', '!=', '<', '>', '<=', '>=', 'in', 'like'
+#(int) "action_value"
-code_open (optional): string, 64 //Название кода открытия
+Пример запроса:
-code_close (optional): string, 64 //Название кода закрытия
-RESPONSE:
 <pre>
 {
-	data:{'response': 'OK'},
+	"scheduler_id": 6 ,
-	error: null
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"name": "New name",
+	"active": 1,
+	"send_sms": 0,
+	"make_call": 1,
+	"armed": 2,
+	"action_id" : 2,
+	"action_device_id" : 2,
+	"action_code_id" : 4,
+	"action_armed" : 0,
+	"action_groups" : 7,
+	"action_repetition" : "1,3",
+	"action_event_time" : "10:00",
+	"action_sensor_type" : 2,
+	"action_logic_operation" : "=",
+	"action_value" : 35,
 }
 </pre>
+Ответ:
-== Добавление розетки ==
+Пример ответа:
+<pre>
+{
+	"result": "Ok" // ответ о том, что запрос отправлен.
+}
+</pre>
-порядок добаления розетки следующий:
+=== Обновление цели события (Update-target) ===
-) Сгенерировать коды
-) Зажать на розетке кнопку, пока она не начнет мигать
+Request URL: [site]/api/scheduler/update-target/
-) Отправить один код
+Параметры запроса:
-) Зажать на розетке кнопку, пока она не начнет мигать
+#(int) target_id,
+#(string) token,
+#(int) "target_type_id",
+#(int) "target_device_id",
+#(int) "target_code_id",
+#(int) "target_armed",
+#(int) "target_groups",   // битовая маска группы от 1 до 8
-) Отправить второй код из сгенерированых
+Пример запроса:
+<pre>
+{
+	"target_id": 6 ,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"target_type_id" : 2,
+	"target_device_id" : 2,
+	"target_code_id" : 4,
+	"target_armed" : 0,
+	"target_groups" : 7
+}
+</pre>
-) Отправить запрос на создание розетки
+Ответ:
+Пример ответа:
-=== Генерация кодов (create-codes) ===
+<pre>
+{
+	"result": "Ok" // ответ о том, что запрос отправлен.
+}
+</pre>
-Request URL: [site]/api/wizard/create-codes
-Params:
+= Логи пользователя (logs) = <!--T:379-->
-controller_id (required): int
+Запрос:
-token (required): string, 64
+<!--T:380-->
+Request URL: [site]/api/profile/logs/
-socket (required): любое значение.
+<!--T:381-->
+Параметры запроса: (string) token, (int) page, (int) limit
-Response:
+<!--T:382-->
+Пример запроса:
 <pre>
 {
-	"error":null,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"data":{
+	"page": 1 // номер страницы лога
-		"response":{"id":30,"masks":"[257, 258]","code_1":"8737025","code_2":"8737026"}
+	"limit": 20 // количество логов на странице , по умолчанию 20, максимум 100
-		}
 }
 </pre>
+Ответ:
-=== Выполнение кода  (execute-code) ===
+Пример ответа:
-Request URL: [site]/api/wizard/execute-code
+<pre>
+[
+	{
+	"id":15,
+	"controller":"Test Valera",
+	"action_name":"",
+	"device":"",
+	"cod":"",
+	"action_pack":"",
+	"date_create":"2019-06-20 15:57:26",
+	"status":0
+	},
+	{
+	"id":14,
+	"controller":"Test Valera",
+	"action_name":"",
+	"device":"",
+	"cod":"",
+	"action_pack":"",
+	"date_create":"2019-06-20 15:57:18",
+	"status":0
+        }
+]
+</pre>
+= Коды = <!--T:383-->
+== Получение информации о коде (info) == <!--T:384-->
-Params:
+<!--T:385-->
+Запрос:
-controller_id (required): int
+<!--T:386-->
+Request URL: [site]/api/property/info/
-token (required): string, 64
+<!--T:387-->
+Параметры запроса:
+#(int) controller_id,
+#(int) device_id,
+#(int) code_id,
+#(string) token
-code (required): int // Берется из сгенерированных
+<!--T:391-->
+Пример запроса:
-Response
 <pre>
 {
-	error: null,
+	"controller_id": 6,
-	data: {'response' => 'OK'}
+	"device_id": 109,
+	"code_id": 192,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
 }
 </pre>
+<!--T:393-->
+Ответ:
-=== Добавление розетки (create-socket) ===
+<!--T:394-->
+Пример ответа (data):
-Request URL: [site]/api/wizard/create-socket
+<pre>
+{
-Params:
+	"id":"1465",
+	"external_cod_id":"59",
-controller_id (required): int
+	"device_id":"1866",
+	"name":"alarm",
-token (required): string, 64
+	"alias":"xxx",
+	"code":"15779537",
-code_1 (required): int
+	"msg_cod":"003001",
+	"send_armed":"INFO",
-code_2 (required): int
+	"send_disarmed":"INFO",
+	"protocol":"1",
-device_name (optional): string, 256
+	"pulse_len":null,
+	"group_1":"0",
-code_off (optional): string, 64 //Название кода открытия
+	"group_2":"0",
+	"group_3":"0",
-code_on (optional): string, 64 //Название кода закрытия
+	"group_4":"0",
+	"group_5":"0",
-RESPONSE:
+	"group_6":"0",
-<pre>
+	"group_7":"0",
-{
+	"group_8":"0",
-	data: {'response':'OK'},
+	"active":"1",
-	error: null
+	"send_sms":"0",
+	"voice_call":"0"
 }
 </pre>
+== Изменение имени кода (update-code-name) == <!--T:395-->
-= Изменение имени кода (update-code-name) =
+Запрос:
+<!--T:396-->
 Request URL: [site]/api/device/update-code-name
-Request Params:
+<!--T:397-->
+Параметры запроса:
-token (required): string(64)
+<!--T:398-->
+#token (required): string(64)
+#code_id (required): int
+#name (optional): string(255)
-code_id (required): int
+<!--T:401-->
+Ответ:
-name (optional): string(255)
+Пример ответа:
-SUCCESS RESPONSE:
 <pre>
 {
@@ Строка 1835: / Строка 2394: @@
 </pre>
+== Редактирование параметров кода (update) ==
-= Получение информации об устройстве (info) =
+<!--T:401-->
+Запрос:
-request:
+<!--T:401-->
+Request URL: [site]/api/property/update/
-Request URL: [site]/api/property/info/
+<!--T:401-->
+Параметры запроса:
-параметры запроса:
+#(string) token
-(int) controller_id,
+#(int) device_id
+#(int) code_id
+#(string) name		// опционально
+#(int) active		// опционально
+#(int) send_sms		// опционально
+#(int) voice_call	// опционально
-(int) device_id,
+<!--T:401-->
+Пример запроса:
-(int) code_id,
-(string) token
-Пример запроса:
 <pre>
 {
-	"controller_id": 6,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	"device_id": 109,
+	"device_id" : 111,
-	"code_id": 192,
+	"code_id" : 111,
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"send_sms": 1
 }
 </pre>
-response:
+<!--T:402-->
-параметры ответа:
+Ответ:
+<!--T:402-->
+Пример ответа (data):
-Пример ответа:
 <pre>
 {
-	"id":"192",
+	"result": "Ok"
-	"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"
 }
 </pre>
+==  Получение кодов по типу сигнала (get-codes-by-subtype) == <!--T:402-->
+Запрос:
-= Обновление информации об устройстве (update) =
+<!--T:403-->
+Request URL: [site]/api/device/get-codes-by-subtype
-request:
+<!--T:404-->
+Параметры запроса:
-Request URL: [site]/api/property/update/
+<!--T:405-->
+#token (required): string(64)
+#device_subtype_id (optional): int, default 0.
-Параметры запроса:
+Ответ:
-(int) device_id,
+Пример ответа:
-(int) code_id,
-(string)name,
-(int) active,
-(string) token
-Пример запроса:
 <pre>
 {
-	"device_id": 107,   // local device id
+	"code"
-	"name": "New name", // new name
+	"id":131,
-	"active": 1,
+	"controller_id":109,
-	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+	"device_type_id":0,
+	"device_subtype_id":1,
+	"code":"655370",
+	"protocol":1,
+	"bit_len":24,
+	"pulse_len":283,
+	"freq":2,"address":null,
+	"num":null,
+	"date_create":"2019-03-13 17:35:05",
+	"device_id":null
+	},
+	"devices":[
+	{
+		"id":"1684",
+		"external_id":"64",
+		"controller_id":"109",
+		"name":"WS 1",
+		"alias":null,
+		"type_id":"12",
+		"password":null,
+		"codes":[178,179,180],
+		"state":"1",
+		"on_dashboard":"0",
+		"active":"1",
+		"new":"1",
+		"family":"DEVICE_FAMILY_RADIO",
+		"camera_id":null,
+		"camera_host":null,
+		"send_sms":"0",
+		"voice_call":"0"
+	},
+	{
+		"id":"1738",
+		"external_id":"115",
+		"controller_id":"109",
+		"name":"Pult 123",
+		"alias":null,
+		"type_id":"3",
+		"password":null,
+		"codes":[280,281,282,283],
+		"state":"1",
+		"on_dashboard":"0",
+		"active":"1",
+		"new":"1",
+		"family":"DEVICE_FAMILY_RADIO",
+		"camera_id":null,
+		"camera_host":null,
+		"send_sms":"0",
+		"voice_call":"0"
+	}
+	]
 }
 </pre>
-response:
+==  Получение списка кодов (get-codes) == <!--T:407-->
-параметры ответа:
+Запрос:
-Пример ответа:
+<!--T:408-->
-<pre>
+Request URL: [site]/api/device/get-codes
-{
-	"resuls" : "Ok"
-}
-</pre>
+<!--T:409-->
+Параметры:
-== ?? Получение кодов по семейству (get-codes-by-subtype) ==
+#token (required): string 64
+#controller_id (required): int
-Request URL: [site]/api/device/get-codes-by-subtype
+Ответ:
-Request Params:
+<!--T:411-->
+Пример ответа:
-token (required): string(64)
+<pre>
+{
-device_subtype_id (optional): int, default 0.
+	data: [
+		{
+			devices:	[
-== ???? методы управлениями places ==
+			{
+				id:	13
-Request URL: [site]/api/places/index (дубликат метода /api/profile/rooms)
+				external_id:	7,
+				controller_id:	5,
+				name:	"Simple device",
-=== Создание места (create) ===
+				type_id:	2,
+				password:	null,
-Request URL: [site]/api/places/create
+				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+				state:	1,
-Request params:
+				on_dashboard:	0,
+				active:	1,
-token (required) : string(64);
+				new:	1,
+				family:	DEVICE_FAMILY_RADIO,
-root (optional): int, default 1;
+				camera_id:	null,
+				camera_host:	null
-lft (optional): int, default 1;
+			},
+			{
-rgt (optional): int, default 4;
+				id:	14
+				external_id:	8,
-lvl (optional): int, default 0;
+				controller_id:	5,
+				name:	"Simple device",
-name (optional): string(255), default "Simple name";
+				type_id:	2,
+				password:	null,
-icon (optional): string(255), default "";
+				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+				state:	1,
-icon_type (optional): int, default 1;
+				on_dashboard:	0,
+				active:	1,
-color (optional): string(8), default "#ccc";
+				new:	1,
+				family:	DEVICE_FAMILY_RADIO,
-active (optional): int, default 1;
+				camera_id:	null,
+				camera_host:	null
-selected (optional): int, default 0;
+			},
+		],
-disabled (optional): int, default 0;
+		code: {
+			id:	12,
-readonly (optional): int, default 0;
+			controller_id: 5,
+			device_type_id:	2,
-visible (optional): int, default 1;
+			code: 498654,
+			protocol: 1,
-collapsed (optional): int, default 0;
+			bit_len: 32,
+			pulse_len:	86,
-movable_u (optional): int, default 1;
+			freq:	77,
+			address:	94,
-movable_d (optional): int, default 1;
+			num:	1,
+			date_create: '2018-04-13 18:29:11"
-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(6), default "black";
+		<!--T:412-->
+}
+		},
-Response:
+		<!--T:413-->
-<pre>
 {
-	data: {"message" => "OK"},
+			devices:	[
-	error: null
+			{
-}
+				id:	13
-</pre>
+				external_id:	7,
+				controller_id:	5,
+				name:	"Simple device",
-=== Редактирование места (edit) ===
+				type_id:	2,
+				password:	null,
-Request URL: [site]/api/places/edit
+				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+				state:	1,
-Request params:
+				on_dashboard:	0,
+				active:	1,
-token (required) : string(64);
+				new:	1,
+				family:	DEVICE_FAMILY_RADIO,
-place_id (required) : int;
+				camera_id:	null,
+				camera_host:	null
-root (optional): int, default 1;
+			},
+			{
-lft (optional): int, default 1;
+				id:	14
+				external_id:	8,
-rgt (optional): int, default 4;
+				controller_id:	5,
+				name:	"Simple device",
-lvl (optional): int, default 0;
+				type_id:	2,
+				password:	null,
-name (optional): string(255), default "Simple name";
+				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+				state:	1,
-icon (optional): string(255), default "";
+				on_dashboard:	0,
+				active:	1,
-icon_type (optional): int, default 1;
+				new:	1,
+				family:	DEVICE_FAMILY_RADIO,
-color (optional): string(8), default "#ccc";
+				camera_id:	null,
+				camera_host:	null
-active (optional): int, default 1;
+			},
+		],
+		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"
-selected (optional): int, default 0;
+		<!--T:414-->
+}
-disabled (optional): int, default 0;
+		},
+	},
+	error: null,
+}
+</pre>
-readonly (optional): int, default 0;
+== Добавление кода к устройству (set-code-to-device) == <!--T:415-->
-visible (optional): int, default 1;
+Запрос:
-collapsed (optional): int, default 0;
+<!--T:416-->
+Request URL: [site]/api/device/set-code-to-device
-movable_u (optional): int, default 1;
+<!--T:417-->
+Параметры запроса:
-movable_d (optional): int, default 1;
+<!--T:418-->
+#token (required): string 64
+#code_id (required): int
+#device_id (required): int
+#name (optional): string 256
-movable_l (optional): int, default 1;
+<!--T:422-->
+Ответ:
-movable_r (optional): int, default 1;
+Пример ответа:
-removable (optional): int, default 1;
-removable_all (optional): int, default 0;
-inverse_text (optional): string(6), default "black";
-Response:
 <pre>
 {
-	data: {"message": "OK"},
+	data:	{
+		id: 5,
+		external_cod_id: 15,
+		device_id: 14,
+		name: "Name"
+		code: 8463517,
+		protocol: 0,
+		pulse_len:	86,
+		active: 1,
+	},
 	error: null
 }
 </pre>
+== Удаление кода (remove-code) == <!--T:423-->
-=== Удаление места (delete) ===
+Запрос:
-Request URL: [site]/api/places/delete
+<!--T:424-->
+Request URL: [site]/api/device/remove-code
-Request params:
+Параметры запроса:
-token (required): string(64);
+<!--T:425-->
+#token (required): string 64
+#code_id (required): int
-place_id (required): int;
+<!--T:427-->
+Ответ:
+Пример ответа:
-Response:
 <pre>
 {
-	data:{"message": "OK"},
+	data:	{
-	error: null
+		message: "OK"
-}
+	},
+	error: null
+}
 </pre>
-== Получение иконок мест (get-icons) ==
+= События = <!--T:428-->
-Request URL: [site]/api/places/get-icons
+== Нажатие кнопки на устройстве (event) == <!--T:429-->
-Response:
+<!--T:430-->
-<pre>
+Запрос:
-{
-	data:{
-		"home":"Home",
-		"industry": "Factory",
-		...
-		},
-	error: null
-}
-</pre>
+<!--T:431-->
+Request URL: [site]/api/device/event/
+Параметры запроса:
-== Удаление устройства (remove-device) ==
+<!--T:432-->
+#(string) controller_name,
+#(int) device_external_id,
+#(int) cod_external_id,
+#(string) token,
+#(int) device_type
-Request URL: [site]/api/device/remove-device
+<!--T:437-->
+Пример запроса:
-PARAMS:
+<!--T:438-->
+<pre>
+{
+	"controller_name": " AS_7F26335CCF4B" ,
+	"device_external_id": 19,
+	"cod_external_id": 1,
+	"device_type": 1,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+}
+</pre>
-token (required): string (64)
+<!--T:439-->
+так как MQTT  односторонний - ответа быть не может. Может быть возвращён ответ, что запрос отправлен:
+response:
-device_id (required): int
+Ответ:
-SUCCESS RESPONSE:
+<!--T:441-->
+Пример ответа (data):
+<!--T:442-->
 <pre>
 {
-	data: {message: 'OK'},
+	"result": "Ok"
-	error: null
 }
 </pre>
+= Места = <!--T:443-->
-==  ?? Добавление кодов (??) ==
+== Получение списка мест (places-list) == <!--T:444-->
+Запрос:
-=== ?? Получение списка кодов и подходящих устройств (get-codes) ===
+<!--T:445-->
+Request URL: [site]/api/places/places-list
-Request URL: [site]/api/device/get-codes
+<!--T:446-->
+Параметры запроса: token (required): string, 64
-PARAMS:
+<!--T:448-->
-token (required): string 64
+Ответ:
-controller_id (required): int
+Пример ответа:
-SUCCESS RESPONSE:
 <pre>
 {
-	data: [
+	"error":null,
-		{
+	"data":{
-			devices:	[
+		"rooms":[
-			{
+				{
-				id:	13
+				"id":1,
-				external_id:	7,
+				"root_id":1,
-				controller_id:	5,
+				"user_id":424,
-				name:	"Simple device",
+				"lvl":0,
-				type_id:	2,
+				"name":"Дом",
-				password:	null,
+				"icon":0,
-				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+				"icon_type":1,
-				state:	1,
+				"color":"#fff2cc",
-				on_dashboard:	0,
+				"readonly":0,
-				active:	1,
+				"visible":1
-				new:	1,
+				},
-				family:	DEVICE_FAMILY_RADIO,
+				{
-				camera_id:	null,
+				"id":2,
-				camera_host:	null
+				"root_id":1,
-			},
+				"user_id":424,
-			{
+				"lvl":1,
-				id:	14
+				"name":"Спальня",
-				external_id:	8,
+				"icon":0,
-				controller_id:	5,
+				"icon_type":1,
-				name:	"Simple device",
+				"color":"#b6d7a8",
-				type_id:	2,
+				"readonly":0,
-				password:	null,
+				"visible":1
-				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,
+</pre>
-				family:	DEVICE_FAMILY_RADIO,
-				camera_id:	null,
-				camera_host:	null
+== Создание места (create) == <!--T:449-->
-			},
-		],
+Запрос:
-		code: {
-			id:	12,
+<!--T:450-->
-			controller_id: 5,
+Request URL: [site]/api/places/create
-			device_type_id:	2,
-			code: 498654,
+<!--T:451-->
-			protocol: 1,
+Параметры запроса:
-			bit_len: 32,
-			pulse_len:	86,
+<!--T:452-->
-			freq:	77,
+#token (required): string, 64
-			address:	94,
+#root (optional): int, default 1
-			num:	1,
+#lft (optional): int, from 1 to 5 //В сумме с rgt должно быть 5
-			date_create: '2018-04-13 18:29:11"
+#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'
+<!--T:473-->
+Ответ:
+Пример ответа:
+<pre>
+{
+	error:null,
+	data: {'message': 'OK'}
+}
+</pre>
+==  Редактирование места (edit) == <!--T:474-->
+Запрос:
+<!--T:475-->
+Request URL: [site]/api/places/edit
+<!--T:476-->
+Параметры запроса:
+<!--T:477-->
+#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'
+<!--T:499-->
+Ответ:
-		}
+Пример ответа:
-		},
-		{
+<pre>
-			devices:	[
+{
-			{
+	error:null,
-				id:	13
+	data: {'message': 'OK'}
-				external_id:	7,
+}
-				controller_id:	5,
+</pre>
-				name:	"Simple device",
-				type_id:	2,
+== Удаление места (delete) == <!--T:501-->
-				password:	null,
-				codes:	"a:4:{i:0;i:46;i:1;i:47;i:2;i:48;i:3;i:45;}",
+Запрос:
-				state:	1,
+<!--T:502-->
-				on_dashboard:	0,
+Request URL: [site]/api/places/delete
-				active:	1,
-				new:	1,
+<!--T:503-->
-				family:	DEVICE_FAMILY_RADIO,
+Параметры запроса:
-				camera_id:	null,
-				camera_host:	null
+<!--T:504-->
-			},
+#token (required): string, 64
-			{
+#place_id (required): int
-				id:	14
-				external_id:	8,
+<!--T:506-->
-				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"
-		}
+<pre>
-		},
+{
-	},
+	error:null,
-	error: null,
+	data: {'message': 'OK'}
 }
 </pre>
-=== Добавление кода к устройству (set-code-to-device) ===
+== Добавление устройства к месту, смена места у устройства (device-in-place) == <!--T:502-->
-Request URL: [site]/api/device/set-code-to-device
+Запрос:
-PARAMS:
+Request URL: [site]/api/places/device-in-place/
-token (required): string 64
+Параметры запроса:
-code_id (required): int
+#token (required): string 64
+#device_id (required): int
+#place_id (required): int
+#visible (not required): int
-device_id (required): int
+Ответ:
-name (optional): string 256
+Пример ответа:
-SUCCESS RESPONSE:
 <pre>
 {
-	data:	{
+	data:	{result: "OK"},
-		id: 5,
-		external_cod_id: 15,
-		device_id: 14,
-		name: "Name"
-		code: 8463517,
-		protocol: 0,
-		pulse_len:	86,
-		active: 1,
-	},
 	error: null
 }
@@ Строка 2277: / Строка 2952: @@
-=== Удаление устройства (remove-device) ===
+== Отвязать устройство от месту (device-out-place) == <!--T:509-->
+Запрос:
+Request URL: [site]/api/places/device-out-place/
-Request URL: [site]/api/device/remove-device
+Параметры запроса:
-PARAMS:
-token (required): string 64
+#token (required): string 64
+#device_id (required): int
+#place_id (required): int
-device_id (required): int
+Ответ:
+Пример ответа:
-SUCCESS RESPONSE:
 <pre>
 {
 	data:	{
-		message: "OK"
+		result: "OK"
 	},
 	error: null
@@ Строка 2296: / Строка 2977: @@
 </pre>
-=== Удаление кода (remove-code) ===
-Request URL: [site]/api/device/remove-code
+== Получить список связей устройство-место (device-place-list) == <!--T:519-->
-PARAMS:
+Запрос:
-token (required): string 64
+Request URL: [site]/api/places/device-place-list/
-code_id (required): int
+Параметры запроса:
-SUCCESS RESPONSE:
+#token (required): string 64
-<pre>
-{
-	data:	{
-		message: "OK"
-	},
-	error: null
-}
-</pre>
+Ответ:
+Пример ответа:
-==  передача локального IP Контроллера (get-ip) ==
-Request URL: [site]/api/ctrl/get-ip
-Request Params:
-token (required): string(64);
-controller_id (required): int;
-SUCCESS RESPONSE:
 <pre>
 {
-	data:'192.168.0.15',
+	"error":null,
-	error: null
+	"data":{
+		"0":{
+			"device_id":1336,
+			"device_name":"Camera test",
+			"place_id":8,
+			"place_name":"office"
+			},
+			...
+		"10":{
+			"device_id":1865,
+			"device_name":"Meteo 9",
+			"place_id":10,
+			"place_name":"Box 1"
+			}
+		}
 }
 </pre>
+==  Активация подписки Ebus  == <!--T:507-->
-==  ?? Активация подписки Ebus -  ==
+<!--T:508-->
 Получение состояния подписки на Контроллере - “in/subscription/get”:
+<!--T:509-->
 <pre>
 {
@@ Строка 2349: / Строка 3027: @@
 </pre>
+<!--T:510-->
 Ответ:
+<!--T:511-->
 <pre>
 {
@@ Строка 2358: / Строка 3038: @@
 }
 </pre>
 Установка подписки на Контроллере - “in/subscription/set”:
+<!--T:513-->
 <pre>
 {
@@ Строка 2369: / Строка 3051: @@
 </pre>
+<!--T:514-->
 Ответ:
 <pre>
 {
@@ Строка 2377: / Строка 3061: @@
 </pre>
+<!--T:515-->
 Идентификаторы подписок:
 SUBSCRIPTION_EBUS = 1
+<!--T:516-->
 Статус Контроллера
+<!--T:517-->
 Контроллер отправляет информацию о своем онлайн/оффлайн статусе в топик “out/status”.
+<!--T:518-->
 Формат сообщения:
 <pre>
@@ Строка 2391: / Строка 3079: @@
 </pre>
+<!--T:519-->
 Поле “status” может принимать следующие значения:
+<!--T:520-->
 • "0" – оффлайн
+<!--T:521-->
 • "1" – онлайн
+<!--T:522-->
 • "2" – онлайн, после включения питания
+<!--T:523-->
 При получении сообщения со статусом "2", портал должен отправить Контроллеру информацию о пользовательских подписках, как это описано в разделе «Подписки».
+= Виджеты = <!--T:524-->
-== ?? Установка подписки на Контроллере - “in/subscription/set”: ==
+== Список виджетов пользователя (widget-list) == <!--T:525-->
-<pre>
-{
+<!--T:525-->
-	"seq_id": 0,
+Запрос:
-	"id": 1, // ID подписки (см. ниже)
-	"remain_time": 100 // оставшееся время в секундах, 4294967295 - неограниченно
+<!--T:526-->
-}
+Request URL: [site]/api/device/widget-list/
-<pre>
-==  Просмотр статуса подписки (get-subscribe-status) ==
+<!--T:527-->
+Параметры запроса:
+(string) token
-Request URL: [site]/api/ctrl/get-subscribe-status
+<!--T:528-->
+Пример запроса:
-params:
+<pre>
+{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae"
+}
-token (required): string(64)
+</pre>
-controller_id (required): int
+<!--T:529-->
+Ответ:
-response:
+<!--T:530-->
+Пример ответа (data):
-{data:{id: 1, controller_id: 40, user_id: 424, remain_time: 100, request_time: 1355314332, response_time: 1355315332, success: 0}, error: ''}
+<pre>
+{
+"widgets":[
+	{
+	"controller_id":111,
+	"device_ids":[18,20,21,22],
+	"device_id":"1824",
+	"external_id":18,
+	"device_type":3,
+	"name":"Remote control",
+	"widget_type":3,
+	"state":1
+	},
+	{
+	"controller_id":111,
+	"device_ids":[18,20,21,22],
+	"device_id":"1850",
+	"external_id":20,
+	"device_type":4,
+	"name":"Sockets",
+	"widget_type":4,
+	"state":1
+	}
+   ],
+"ctrl_widgets":[
+   {
+	"controller_id":111,
+	"name":"66D4E809EF0A",
+	"hostname":"Test",
+	"armed":0
+   }
+]
+}
+</pre>
+== Добавить виджет (widget-add-home) == <!--T:525-->
-==  Активация/продление/покупка подписки (set-subscribe) ==
+<!--T:525-->
+Запрос:
+<!--T:525-->
+Request URL: [site]/api/device/widget-add-home/
-Request URL: [site]/api/ctrl/set-subscribe
+<!--T:525-->
+Параметры запроса:
-params:
+<!--T:525-->
+#(string) token,
+#(int) device_id,
+#(int) controller_id
-token (required): string(64)
+<!--T:525-->
+Пример запроса:
-controller_id (required): int
-response:
 <pre>
 {
-	data:{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-		id: 1,
+	"controller_id": 1862
-		controller_id: 40,
-		user_id: 424,
-		remain_time: 100,
-		request_time: 1355314332,
-		response_time: 1355315332,
-		success: 0
-	},
-	error: ''
 }
 </pre>
+<!--T:525-->
+Ответ:
-==  ? Метод получения списка телефонов (get-phones) ==
+<!--T:525-->
+Пример ответа (полный):
+<pre>
+{
+	"error":null,
+	"data":{
+	"result":"Ok"
+	}
+}
+</pre>
-Request URL: [site]/api/ctrl/get-phones
+== Удалить виджет пользователя (widget-remove-home) == <!--T:525-->
-Params:
+<!--T:525-->
+Запрос:
-token (required): string, 64
+Request URL: [site]/api/device/widget-remove-home/
-controller_id (required): int
+<!--T:525-->
+Параметры запроса:
-type (optional): string,
+#(string) token,
-range ['recipient', 'authorized', 'all'], default 'all'
+#(int) device_id,
+#(int) controller_id
-Response:
+<!--T:525-->
+Пример запроса:
 <pre>
 {
-	'error': null,
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
-	data: [
+	"device_id": 1862
-		{'id': 5, 'phone': '+380123456789'},
+}
-		{'id': 6, 'phone': '+380123334455'},
+</pre>
-		{'id': 7, 'phone': '+380112223344'}
-	]
+<!--T:525-->
-}
+Ответ:
-</pre>
+<!--T:525-->
+Пример ответа (полный):
-==  Редактирование телефона (edit-phone) ==
+<pre>
-Request URL: [site]/api/ctrl/edit-phone
+{
+	"error":null,
-Params:
+	"data":{
+		"result":"Ok"
-token (required): string, 64
+	}
+}
-phone_id (required): int
+</pre>
-is_recipient (optional): int
+= Неклассифицируемые методы = <!--T:524-->
-is_authorized (optional): int
+== Список доступных стран (countries) ==
-phone (optional): string
+<!--T:525-->
-Response:
+Запрос:
-<pre>
-{
+<!--T:526-->
-	"error":null,
+Request URL: [site]/api/profile/countries/
-	"data":{
-		"id":2,
+<!--T:527-->
-		"controller_id":81,
+Параметры запроса:
-		"phone":"+380503334455",
+#(string) token
-		"is_recipient":"1",
+#(string) lang	// en , ua, ru
-		"is_authorized":0
+<!--T:528-->
+Пример запроса:
+<pre>
+{
+	"token":"_zcX0_QceAqgP_seIvjG32EC3HMO34ae",
+	"lang" : "en"
+}
+</pre>
+<!--T:529-->
+Ответ:
+<!--T:530-->
+Пример ответа (data):
+<pre>
+[
+	{
+		"id":"1",
+		"code":"AF",
+		"name":"Afghanistan"
+	},
+	{
+		"id":"2",
+		"code":"AL",
+		"name":"Albania"
+	}
+]
+</pre>
+= Ошибки = <!--T:524-->
+<!--T:525-->
+параметры ошибки:
+пример:
+<!--T:526-->
+<pre>
+{
+	"errors":{
+		"password": [
+			"Incorrect username."
+		]
 	}
 }
@@ Строка 2513: / Строка 3307: @@
-==  Удаление телефона (delete-phone) ==
-Request URL: [site]/api/ctrl/delete-phone
-Params:
-token (required): string, 64
-phone_id (required): int
-Response:
-<pre>
-{
-	"error":null,
-	"data":{"response":"OK"}
-}
-</pre>
-== Добавление телефона (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:
-<pre>
+</translate>
-{
-	"error":null,
-	"data":{
-		"id":2,
-		"controller_id":81,
-		"phone":"+380503334455",
-		"is_recipient":"1",
-		"is_authorized":0
-	}
-}
-</pre>
-</pre>

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

Текущая версия на 16:12, 30 июля 2019

Содержание

Общие сведения

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

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

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

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

Контроллеры

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

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

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

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

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

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

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

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

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

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

Получение конфигурации Контроллера (config)

Изменение конфигурации контроллера(config-set)

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

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

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

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

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

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

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

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

Информация о версии прошивки контроллера (fw-version-current)

Информация о последней версии прошивки контроллера (get-new-fw-version)

Устройства

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сирена (create-siren)

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

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

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

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

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

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

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

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

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

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

Сценарии

Получение списка сценариев (list)

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

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

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

Обновление/добавление действий и событий сценария (Update-action)

Обновление цели события (Update-target)

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

Коды

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

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

Редактирование параметров кода (update)

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

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

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

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

События

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

Места

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

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

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

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