9. [DKSF 58.1.11] Поддержка HTTP API
HTTP API | |||
Команда | Вызов | Ответ | Примечание |
Линии дискретного входа | |||
Запрос состояния линии | /in.cgi?inN Где: N — номер линии | in_result('error') in_result('ok', -1, 1, 339) Первый аргумент: всегда 'ok' (при ошибке запроса — 'error'). Второй аргумент: всегда «-1», для расширения API в будущем. Третий аргумент: текущее моментальное состояние IO-линии, включая состояние сброса. Четвертый аргумент: счетчик импульсов на данной IO-линии, считается по фронту. | |
Запрос состояния всех линий | /in.cgi?in | in_result('error') in_result('ok', 15); Первый аргумент: всегда 'ok' (при ошибке запроса — 'error'). Второй аргумент: бит-карта состояния линий. | Бит-карта (представлена в десятичном формате): бит 0 = линия 1 бит 1 = линия 2 бит 2 = линия 3 бит 3 = линия 4 Например: 00000000 — 0 (все линии в лог.0) 00000111 — 7 (на линии 4 лог.0, на остальных - лог.1) |
Линии дискретного выхода | |||
Управление линией Otput | /out.cgi?outN=S N — номер линии (1-2 Output) S — режим работы (1 — вкл., 0 — выкл.) | out_result('error') out_result('ok') | |
Ресет, переключение линии в инверсное состояние на время в режиме «выход» | /out.cgi?outN=f N — номер линии (1-2 Output) | out_result('error') out_result('ok') | |
Выдать импульс | /out.cgi?outN=1,T N — номер линии 1 - включение линии T — время переключения в с. | out_result('error') out_result('ok') | |
Термодатчики | |||
Запрос состояния датчика | /thermo.cgi?tN Где: N — номер датчика | thermo_result('error') thermo_result('ok', 36, 2); Первый аргумент: всегда 'ok' (при ошибке запроса — 'error'). Второй аргумент: текущая температура. Третий аргумент: статус датчика. 0 — датчик не подключен или сбоит; 2 — датчик в норме; |
Авторизация
Для добавления в структуру HTTP API-команды логина и пароля можно воспользоваться следующей схемой:
http://<имя_пользователя>:<пароль>@<хост>:<порт>/<URL‐путь>?<параметры>
где:
<имя_пользователя>:<пароль> — учетные данные для авторизации в web-интерфейсе устройства;
<хост> — IP-адрес устройства;
<порт> — порт HTTP-сервера;
<URL‐путь>?<параметры> — HTTP API-команда.