Датчики и холодовая цепь: как это работает
Раздел «Датчики и холодовая цепь» принимает показания ваших устройств (регистраторов холодильников, морозильников и помещений, датчиков топливных баков) через API с отдельным ключом для каждого устройства, вызывает оповещение в приложении, push-уведомлением и по e-mail, если показание остаётся вне диапазона или устройство перестаёт выходить на связь, и показывает кривую каждого устройства с минимумом, максимумом, средним и временем в диапазоне.
Урок 5 из 12 · Как это работает
Как это работает
Откройте Датчики и холодовая цепь и добавьте устройство с его серийным номером (id, который отправляет устройство). Холодильник сразу получает диапазон 2–8 °C, а морозильник — не выше −18 °C; диапазоны можно изменить на странице устройства.
На странице устройства выберите «Create key». Ключ показывается один раз: внесите его в устройство или его шлюз. Им можно только передавать показания этого устройства.
Устройство отправляет данные на /api/v1/sensors/readings — до 500 показаний за запрос (температура, влажность, уровень топлива или любое число) с заголовком Idempotency-Key, чтобы повторная отправка никогда не учитывалась дважды. В справочном центре есть пример curl.
У каждого диапазона есть задержка: показание вне диапазона дольше задержки открывает оповещение, и люди с правами на датчики получают его в приложении, push-уведомлением и по e-mail. Когда показание возвращается в диапазон, оповещение закрывается, и об этом тоже сообщается. Устройство, молчащее дольше заданного числа минут, вызывает оповещение «silent».
Подтвердите оповещение с примечанием о том, что было сделано (товар перемещён, дверь закрыта). Примечание остаётся с оповещением для проверок.
Страница устройства показывает кривую за 24 часа, 7 или 30 дней с допустимой полосой, минимум, максимум, среднее, долю времени в диапазоне и выходы за диапазон.
Исходные показания хранятся заданное вами число дней (по умолчанию 30), а затем сводятся по часам, так что длинные периоды открываются быстро. Устройство также может автоматически заполнять журнал единицы холодовой цепи в разделе Склад → Холодовая цепь.
Где это найти
- Sensors & cold chain
/admin/sensors
Настройки, которые на это влияют
- Sensors & cold chain → Retention
/admin/sensors
Чек-лист
Прежде чем идти дальше, проверьте, что вы умеете:
- Открыть Sensors & cold chain
- Откройте Датчики и холодовая цепь и добавьте устройство с его серийным номером (id, который отправляет…
- На странице устройства выберите Create key.
- Устройство отправляет данные на /api/v1/sensors/readings — до 500 показаний за запрос (температура,…
- У каждого диапазона есть задержка: показание вне диапазона дольше задержки открывает оповещение, и люди с…
Советы и частые ошибки
- Задайте для диапазона задержку в несколько минут, чтобы дверь, открытая для погрузки, не вызывала оповещения.
- Выводите из работы устройство, которым больше не пользуетесь: его ключ сразу перестаёт действовать, а показания сохраняются.
- Ключ для одного устройства — самый безопасный вариант; общий ключ с областью sensors:write должен указывать серийный номер устройства в каждой загрузке.