Як отримати історію сигналу ONU по ID або MAC через API (PMON)

Для аналізу якості оптичної лінії важливо не тільки бачити поточний рівень сигналу, а й розуміти, як він змінювався з часом.
У системі PMON це реалізовано через API історії сигналів ONU.

У цій статті розберемо, як отримати історію сигналу ONU по ID або MAC, що саме повертає API і як правильно використовувати ці дані.

Для чого потрібна історія сигналу ONU

Історія сигналу дозволяє:

• побачити деградацію оптичної лінії

• визначити момент погіршення RX

• перевірити стабільність сигналу за місяць

• виключити дублікати та «шум» у вимірюваннях

• використовувати дані для графіків та аналітики

PMON зберігає історію і віддає її через API у зручному форматі.

Endpoint для отримання історії

GET /get.php

Основна дія:

do=history

Авторизація

Для доступу використовується API-ключ:

key=ВАШ_API_КЛЮЧ

Без ключа API не поверне дані.

Варіанти запиту історії сигналу

API підтримує два способи ідентифікації ONU:

▶️ Варіант 1. Історія сигналу по ID ONU (PMON)

Якщо ONU вже зареєстрована в системі PMON, найзручніше використовувати її внутрішній ID.

Приклад запиту:

/get.php?do=history&key=hibRahEOHHk72gd&data=4072

data=4072 — ID ONU в системі PMON
 Якщо data містить тільки цифри, API автоматично визначає, що це ID ONU

▶️ Варіант 2. Історія сигналу по MAC-адресі ONU

Якщо ID невідомий, можна використовувати MAC-адресу ONU.

Приклад:

/get.php?do=history&key=hibRahEOHHk72gd&data=50:5b:1d:c4:5a:83

У цьому випадку PMON самостійно знаходить ONU та повертає історію сигналу.

Формат відповіді API

У разі успішного запиту API повертає відповідь у форматі JSON.

Приклад відповіді:

{
    "success": true,
    "message": {
        "history": [
            {
                "rx": -16.45,
                "time": "2026-02-01 00:30:53"
            },
            {
                "rx": -16.42,
                "time": "2026-02-01 04:34:22"
            },
            {
                "rx": -16.53,
                "time": "2026-02-01 09:31:13"
            },
            {
                "rx": -16.49,
                "time": "2026-02-01 11:31:20"
            }
        ]
    }
}

Що означають поля у відповіді

history

Масив історичних значень сигналу ONU.

Кожен елемент містить:

Як формується історія сигналу

PMON повертає:

• дані за поточний місяць

• без дублювання однакових значень

• тільки реальні зміни сигналу

Якщо сигнал протягом місяця не змінювався — у відповіді буде один запис.
Якщо сигнал змінювався — кожна зміна буде окремим елементом.

Це дозволяє отримати чисту та наочну історію, готову для побудови графіків.

Де це зручно використовувати

• графік RX ONU у кабінеті абонента

• технічна підтримка (аналіз проблем)

• моніторинг деградації PON

• автоматичні алерти

• внутрішня аналітика мережі