API - usm billing - get user list
См.: Методы универсального API
Метод: get_user_list
Описание: Абоненты/клиенты
Добавлен в версии API: 1.0
Запрос: ?key=apikey&request=get_user_list Результат: http://demo.userside.eu/api.php?key=keyus&cat=module&request=get_user_list
Ответ идёт по всем абонентам кроме удалённых. Также есть возможность указать ID конкретного абонента
?key=apikey&request=get_user_list&customer_id=999
В качестве индекса массива выступает идентификатор абонента [] => array( 'id' => id 'login' => имя учетной записи 'full_name' => полное ФИО/название 'flag_corporate' => флаг – юридическое лицо 'tariff' => array( - тарифные планы (стандартные) 'current' => array( - текущие планы (действующие) [] => array( - вложенный массив 'id' => id 'date_finish' => дата окончания срока действия тарифа ) 'new' => array( - новые планы (заказанные) [] => array( - вложенный массив 'id' => id 'date_start' => дата начала срока действия тарифа ) ) 'agreement' => array( - договора с клиентом [] => array( - вложенный массив 'number' => номер 'date' => дата ) ) 'account_number' => номер лицевого счета 'group' => array( - группы абонента [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор группы 'id' => id ) ) 'comment' => заметки 'balance' => остаток на счету 'credit' => кредит 'state_id' => id статуса работы. 'date_create' => дата создания 'date_connect' => дата начала работы 'date_activity' => дата последней активности абонента (активность в интернете и т.п. деятельность внутри сети. Но не считая, например, вход в личный кабинет извне сети) 'traffic' => array( - трафик по абоненту (bytes) 'month' => array( - за последние 30 дней 'up' => входящий 'down' => исходящий ) ) 'discount' => скидка 'address' => array( - адрес [] => array( - вложенный массив 'full_name' => текстовый адрес (не использовать, если будет указан идентификатор дома) 'type' => тип адреса (возможные значения: "connect" – точка подключения, "legal" – регистрация/прописка, "post" – для корреспонденции) 'house_id' => id дома 'apartment' => array( - квартира/Помещение 'id' => id 'full_name' => полное наименование 'number' => номер (если есть) 'block' => буква/наименование помещения (если есть) ) 'entrance' => номер подъезда 'floor' => номер этажа ) ) 'phone' => array( - телефоны [] => array( - вложенный массив 'number' => номер (только цифры и символ "+") 'flag_main' => флаг – главный номер 'comment' => заметки ) ) 'email' => Электронные почтовые адреса
[‘…’] => (вложенный массив)
'address’] => Адрес 'flag_main’] => Флаг – главная запись 1/0 'comment’] => Заметки 'ip_mac’] => IP/MAC-адреса (текущие. Под которыми разрешено работать или прямо сейчас работает абонент)
[] => (в качестве индекса массива выступает inet_aton(IP) или счетчик (для подсетей))
'ip’] => IP-адрес (единичный). В inet_aton-формате 'mac’] => MAC-адрес. В нижнем регистре. Без разделителей. 'ip_net’] => Подсеть IP-адресов (если используется) 'additional_data’] => Дополнительные данные по абоненту (в т.ч. настраиваемые поля)
[] => (в качестве индекса массива выступает идентификатор доп.поля)
'id’] => Идентификатор доп.поля 'value’] => Значение (в формате поля) 'account`] => Учетные записи
[] => (в качестве индекса массива выступает идентификатор уч.записи)
'id`] => Идентификатор учётной записи 'login`] => Наименование уч.записи
… используются прочие элементы, указанные для клиента в целом (например – заметки, баланс, состояние работы) – в случае если у учетных записей существуют такие параметры
'tag’] => Метки абонента
[] => (в качестве индекса массива выступает идентификатор метки)
'id`] => Идентификатор метки 'date_add`] => Дата установки метки 'service`] => Услуги
[]=> (в качестве индекса массива выступает идентификатор услуги) [`…`] => (вложенный массив)
'cost`] => Стоимость для абонента 'date_add’] => Дата добавления 'comment’] => Заметки 'mark’] => Метки абонента (булевые)
[] => (в качестве индекса массива выступает идентификатор метки)
'id`] => Идентификатор метки 'password’] => Пароль абонента
)