Документация · версия 3.0
PTL — документация
PTL — система световой комплектации: веб-интерфейс управляет PTL-модулями через контроллеры Modbus TCP и показывает состояние склада в реальном времени.
Интерфейс
Как устроен веб-интерфейс: обзор, управление модулями, назначение адресов, события, сценарии, аналитика, метрики и конфигурация.
API
HTTP и WebSocket API 3.0: соглашения, все эндпоинты, параметры, ответы, ошибки и примеры запросов.
Развёртывание
Установка Linux-бинаря, Redis, настройка контроллеров, systemd, вебхуки и демо-режим.
С чего начать
-
Установите сервис по инструкции по развёртыванию
и укажите контроллеры в
/etc/ptl_api/config.json. -
Откройте веб-интерфейс по адресу
http://<сервер>:8000/и проверьте, что контроллеры в статусе Online. - Настройте адреса модулей во вкладке «Настройка», затем проверьте зажигание во вкладке «Управление».
- Для интеграции с WMS используйте HTTP API и вебхуки.
Демо без оборудования. Публичный стенд — ptl-demo.whsoft.ru. Он работает в демо-режиме и сбрасывается каждые 15 минут.
Версия и совместимость
Документация описывает PTL 3.0. Проверить версию установленного
сервиса можно в интерфейсе, в разделе
«О приложении», или запросом
GET /version.
| Компонент | Требование |
|---|---|
| ОС | Linux x86_64, Ubuntu 22.04+ или совместимый дистрибутив |
| Redis | 7+ — состояние модулей, события, история |
| Контроллеры | Modbus TCP, порт 502 |
| Браузер | Современный Chrome, Firefox, Edge или Safari |
Доступ. В веб-интерфейсе и API нет встроенной авторизации. Ограничивайте доступ сетью объекта, VPN или reverse proxy с Basic Auth. Не публикуйте порт 8000 в интернет.