API - usm billing - get user list: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
 
(не показаны 4 промежуточные версии этого же участника)
Строка 8: Строка 8:


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

Текущая версия от 11:06, 4 мая 2018

См.: Методы универсального API

Метод: get_user_list

Описание: Абоненты/клиенты

Добавлен в версии API: 1.0

Запрос:
?key=apikey&cat=module&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' => array( - электронные почтовые адреса
   [] => array( - вложенный массив
     'address' => адрес почты
     'flag_main' => флаг – главная запись
     'comment' => заметки
   )
 )
 'ip_mac' => array( - ip/mac-адреса (текущие. Под которыми разрешено работать или прямо сейчас работает абонент)
   [] => array( - вложенный массив - в качестве индекса массива выступает inet_aton(ip) или счетчик (для подсетей)
     'ip' => ip-адрес (единичный)
     'mac' => mac-адрес
     'ip_net' => подсеть ip-адресов (если используется)
   )
 )
 'additional_data' => array( - дополнительные данные по абоненту (в т.ч. настраиваемые поля)
   [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор доп.поля
     'id' => id доп.поля
     'value' => значение (в формате поля)
    )
 )
 'account' => array( - учетные записи
   [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор уч.записи
     'id' => id
     'login' => наименование уч.записи
     … используются прочие элементы, указанные для клиента в целом (например – заметки, баланс, состояние работы) – в случае если у учетных записей существуют такие параметры
   )
 )
 'tag' => array( - метки абонента
   [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор метки
     'id' => id
     'date_add' => дата установки метки
   )
 )
 'service' => array( - услуги
   [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор услуги
     [] => array( - вложенный массив (у абонента может быть сразу несколько услуг одного типа)
       'cost' => стоимость
       'date_add' => дата добавления
       'comment' => заметки
     )
   )
 )
 'mark' => array( - метки абонента (булевые)
   [] => array( - вложенный массив - в качестве индекса массива выступает идентификатор метки
     'id' => id
   )
 )
 'password' => пароль
)