Як виконати пошук ONU: пошук по MAC або серійному номеру через API (PMON)

У системі PMON реалізований зручний API-механізм пошуку ONU, який дозволяє швидко знайти абонентський термінал по MAC-адресі або серійному номеру, навіть якщо він зареєстрований на різних OLT.

У цій статті розберемо:

• як виконати API-запит для пошуку ONU

• які дані повертає система

• що робити, якщо знайдено кілька ONU

• як використовувати результат у подальших запитах (history, snmp)

Навіщо потрібен API-пошук ONU

API пошуку в PMON використовується для:

• швидкого визначення ID ONU

• роботи з абонентами без доступу до OLT

• інтеграції з CRM або білінгом

• автоматизації техпідтримки

• подальшого запиту історії сигналу або статусу

Фактично, це перший крок у роботі з API PMON.

Endpoint для пошуку ONU

GET /get.php

Основна дія:

do=search

Авторизація

Кожен запит до API повинен містити API-ключ:

key=ВАШ_API_КЛЮЧ

Як виконати запит пошуку

Пошук ONU по MAC-адресі або серійному номеру

У параметрі data передається:

• MAC-адреса ONU
  або

• серійний номер ONU (повністю або частково)

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

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

Якщо data містить літери або символи — система автоматично обробляє його як MAC або SN.

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

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

Приклад відповіді з кількома результатами:

{
    "success": true,
    "message": {
        "list": [
            {
                "idonu": 30920,
                "status": 2,
                "onukey": "50:5b:1d:c4:5a:a3",
                "rx": 0,
                "pon": "epon",
                "inface": "0/7:29",
                "olt": {
                    "model": "BDCOM P3600-16E",
                    "name": "OLT.168",
                    "ip": "172.1.1.168"
                }
            },
            {
                "idonu": 31276,
                "status": 1,
                "onukey": "50:5b:1d:c4:5a:a3",
                "rx": -19.8,
                "pon": "epon",
                "inface": "0/9:41",
                "olt": {
                    "model": "BDCOM P3600-16E",
                    "name": "OLT.167",
                    "ip": "172.1.1.167"
                }
            }
        ]
    }
}

Пояснення полів відповіді

Дані ONU

Інформація про OLT

Що означає кілька результатів

Якщо API повертає кілька ONU:

• однаковий MAC або SN може бути:

  • зареєстрований на різних OLT

  • у різних PON-гілках

• це нормально для великих мереж

У такому випадку клієнт:

• обирає потрібний idonu

• використовує його для подальших запитів