MBLibExternal_APIUserManager

API-модуль управления абонентами MikBiLL. Позволяет создавать абонентов, получать их данные и обновлять информацию через HTTP-запросы.

Версия: 1.0.0
Дата: 2026-04-14

Перед использованием API необходимо настроить системные опции в админ-панели MikBiLL (префикс usermanager_):

Все запросы передаются через массив $inputData с обязательными полями:

При каждом запросе выполняются проверки в следующем порядке:

1. IP-адрес — клиентский IP должен входить в список разрешённых (usermanager_network).
2. Статус API — опция usermanager_on должна быть равна 1.
3. API-ключ — параметр key должен совпадать с usermanager_key.
4. Наличие метода — параметр request должен быть указан и соответствовать одному из поддерживаемых методов.

Формат ответа при ошибке:

{
    "error": "Текст ошибки",
    "error_code": 2
}

Возвращает список всех поддерживаемых методов API.

Параметры: нет (только key и request)

Ответ:

{
    "get_supported_method_list": { "comment": "Return Supported Method List" },
    "get_api_information": { "comment": "Return API Version" },
    "create_user": { "comment": "Create new subscriber by connection template" },
    "get_user_data": { "comment": "Get subscriber data by uid" },
    "update_user": { "comment": "Update subscriber data" }
}

Возвращает версию и дату API.

Параметры: нет

Ответ:

{
    "version": "1.0.0",
    "date": "2026-04-14"
}

Создание нового абонента по шаблону подключения. Аналог createabonentfromconnectiontemplateExtjs.

При создании автоматически:

• списывается абонплата (если положена);
• подключаются базовые услуги тарифа.

• Если логин уже занят и включена сисопция autogen_login_do, логин генерируется автоматически.
• Если включена сисопция generate_pwd_unique, пароль проверяется на уникальность.

{
    "result": "ok",
    "uid": 12345,
    "login": "subscriber01"
}

https://admin.mikbill.pro/json/index/usermanager?key=MY_API_KEY&request=create_user&connectiontemplateid=1&user=newuser&password=pass123&gid=5&fio=Иванов Иван&phone=0501234567

Получение полных данных абонента по uid. Аналог getuserdatambpAjax.

{
    "uid": 12345,
    "login": "subscriber01",
    "fio": "Иванов Иван Иванович",
    "state_id": 1,
    "flag_corporate": 0,
    "deposit": 150.50,
    "credit": 0,
    "gid": 5,
    "tariff_name": "Турбо 100",
    "gidd": 0,
    "tariff_next_name": "",
    "phone": "0501234567",
    "mob_tel": "",
    "sms_tel": "0501234567",
    "email": "user@example.com",
    "date_connect": "2024-01-15",
    "numdogovor": "D-12345",
    "date_contract": "2024-01-15",
    "blocked": 0,
    "user_installed": 1,
    "houseid": 42,
    "house": "15",
    "lane": "ул. Центральная",
    "settlementname": "г. Киев",
    "app": "101",
    "porch": 2,
    "floor": 5,
    "address": "",
    "sectorid": 3,
    "sector": "Сектор-1",
    "local_ip": "10.0.0.15",
    "local_mac": "AA:BB:CC:DD:EE:FF",
    "framed_ip": "192.168.1.15",
    "swid": 7,
    "switchname": "SW-Main-01",
    "switchport": 12,
    "speed_rate": "100M/100M",
    "speed_burst": "",
    "online": 1,
    "usersgroupid": 0,
    "comment": "",
    "inn": "",
    "date_birth": "1990-05-20",
    "discount": 0,
    "passportserie": "",
    "passportpropiska": "",
    "passportgdevidan": "",
    "custom_fields": {
        "ext_legal_person": "0",
        "ext_date_fiz_contract_conclusion": "2024-01-15"
    }
}

Обновление данных абонента. Аналог updateuserExtjs.

Помимо uid, необходимо передать хотя бы одно поле для обновления.

Любые поля с префиксом ext_, например:

Метод updateUser может вернуть дополнительные коды ошибок:

{
    "result": "ok",
    "uid": 12345
}

https://admin.mikbill.pro/json/index/usermanager?key=MY_API_KEY&request=update_user&uid=12345&fio=Петров Пётр&phone=0509876543&gid=7

# Получить информацию об API
curl "https://admin.mikbill.pro/json/index/usermanager?key=MY_API_KEY&request=get_api_information"

# Создать абонента
curl -X POST "https://admin.mikbill.pro/json/index/usermanager" \
  -d "key=MY_API_KEY" \
  -d "request=create_user" \
  -d "connectiontemplateid=1" \
  -d "user=newuser" \
  -d "password=SecurePass123" \
  -d "gid=5" \
  -d "fio=Иванов Иван" \
  -d "phone=0501234567" \
  -d "houseid=42" \
  -d "app=101"

# Получить данные абонента
curl "https://admin.mikbill.pro/json/index/usermanager?key=MY_API_KEY&request=get_user_data&uid=12345"

# Обновить данные абонента
curl -X POST "https://admin.mikbill.pro/json/index/usermanager" \
  -d "key=MY_API_KEY" \
  -d "request=update_user" \
  -d "uid=12345" \
  -d "gid=7" \
  -d "phone=0509876543"

$params = [
    'key'     => 'MY_API_KEY',
    'request' => 'get_user_data',
    'uid'     => 12345,
];
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://admin.mikbill.pro/json/index/usermanager');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);