Получить долгоживущий аутентификационный токен ZONT по логину/паролю.

Требует, чтобы сервер был запущен с ZONT_LOGIN и ZONT_PASSWORD. Полученный токен можно передать в переменную окружения ZONT_TOKEN для последующих запусков.

client_name: человекопонятное название приложения, запрашивающего токен.

Получить список всех устройств пользователя ZONT и их настроек.

load_io: возвращать ли в поле io текущие состояния каждого устройства.

Добавить новое устройство в аккаунт пользователя ZONT.

devtype: идентификатор типа устройства, например T100, T102, L1000, ZTC-700, SX250 и т.д. name: название устройства для пользователя. serial: серийный номер устройства. timezone: часовой пояс устройства. tel_password: телефонный пароль для GSM-устройств (только цифры). notes: произвольные заметки об устройстве. wifi_credentials: параметры Wi-Fi сетей вида [{"ssid": ..., "password": ...}] (только для устройств с Wi-Fi). boiler_vendor: производитель котла. boiler_model: модель котла.

Удалить устройство из аккаунта пользователя ZONT (или передать другому пользователю).

device_id: ID устройства. transfer: передать устройство другому пользователю вместо удаления. transfer_username: логин пользователя-получателя (только если transfer=true). clear_access: отозвать доступ других пользователей к устройству. clear_data: удалить все накопленные данные устройства.

Изменить настройки устройства ZONT.

Например режим термостата, целевые температуры, доверенные номера и т.д. Передайте только те поля настроек, которые нужно изменить — остальные сохранят прежние значения. Полный список возможных настроек описан в разделе «Параметры устройств» документации ZONT API (общие, беспроводная сеть, автомобиль, отопление).

device_id: ID устройства. settings: объект настроек устройства, которые нужно изменить, например {"thermostat_mode_temps": {"comfort": 21}}.

Отправить устройству команду на изменение состояния.

Управляет охраной (guard-state), сиреной (siren), блокировкой двигателя (engine-block), подогревателем (webasto) или автозапуском (auto-ignition). Команда доставляется, только когда устройство на связи.

portname: имя состояния, которым нужно управлять. type: тип значения — "string" для guard-state, "auto-ignition" для auto-ignition, "bool" для остальных. value: требуемое значение — true/false для bool; "enabled"/"disabled" для guard-state; объект {"state": ..., "time"?: ...} для auto-ignition.

Отправить устройству (ZTC-7xx, Mega SX) пользовательскую команду.

Команды заданы в настроечной утилите. Идентификатор команды берётся из настройки custom_controls устройства (см. zont_list_devices).

device_id: ID устройства. command_id: ID команды.

Отправить недокументированную z3k-команду устройству (H-2000+/H1V/Climatic и т.п.).

ВНИМАНИЕ: метод send_z3k_command отсутствует в официальной документации ZONT API. Формат восстановлен вручную перехватом сетевых запросов веб-интерфейса ZONT (my.zont.online) — используй осторожно и проверяй результат через zont_list_devices.

Известный пример: изменение целевой температуры контура отопления — command_name="TargetTemperature", object_id=<id контура из z3k_config.heating_circuits или z3k_config.boiler_adapters>, command_args={"value": <новая температура>}.

device_id: ID устройства. object_id: ID объекта z3k (например, id отопительного контура). command_name: имя команды (например "TargetTemperature"). command_args: аргументы команды, например {"value": 19}. firmware_version: версия прошивки устройства (из devices[].firmware_version[0]); если не передать, будет опущена в запросе. is_guaranteed: требовать ли гарантированную доставку команды (по умолчанию true).

Загрузить историю данных устройств.

Показания температурных датчиков, работа термостата, GPS-треки, события, состояние контроллера и т.д. Можно запросить несколько устройств и типов данных за один вызов. Временные метки — unix time (секунды с 1970-01-01 UTC).

requests: список запросов вида {"device_id": int, "data_types": [str, ...], "mintime"?: int, "maxtime"?: int}. data_types, например: temperature, thermostat_work, gps, events, custom_controls, z3k_temperature, z3k_boiler_adapter, ztc_state.

Получить историю событий устройства за заданный промежуток времени.

Постановка/снятие с охраны, тревоги, GPS/GSM, автозапуск и т.д.

device_id: ID устройства. mintime: начало диапазона (unix time, включительно). maxtime: конец диапазона (unix time, включительно). only: возвращать только события этих типов. except_: не возвращать события этих типов (соответствует полю "except" в API).

Запросить создание архива со всеми данными устройства за период времени.

Возвращает archive_id, который затем нужно передать в zont_download_archive.

device_id: ID устройства. mintime: начало диапазона (unix time, включительно). maxtime: конец диапазона (unix time, включительно). split_by: разбиение файлов внутри архива — по дням ("days") или по месяцам ("months").

Скачать zip-архив, ранее созданный zont_generate_archive, и сохранить на диск.

archive_id: идентификатор архива, полученный от zont_generate_archive. output_path: путь к файлу, куда сохранить скачанный zip-архив.