Справочный центр Wialon

get_account_data

Для получения подробной информации об учетной записи используйте следующую сигнатуру метода account/get_account_data:

Copied!
svc=account/get_account_data&params={"itemId":<long>,
                                     "type":<uint>}

Для получения информации о нескольких учетных записях используйте следующую сигнатуру:

Copied!
svc=account/get_account_data&params={"itemId":[<long>],
                                     "type":<uint>}

Параметры

Запрос может содержать следующие параметры. Обязательные параметры отмечены звездочкой (*).

Параметр Описание
itemId* ID ресурса (учетной записи).
type Флаг ответа. Типы ответа:
  • 1 — минимальная информация, обычно требуемая для оценки состояния авторизованного пользователя;
  • 2 — подробная информация с комбинированными, персональными настройками и настройками тарифного плана;
  • 4 — исключает подчиненные учетные записи из usage. Информация касается только этой учетной записи;
  • 8 — подробная информация о персональных сайтах.
  • Ответ

    Если запрос выполнен успешно, ответ для одной учетной записи имеет следующий вид:

    Copied!
    {
        "parentAccountName":<text>, /* Название родительской учетной записи. */
        "parentAccountId":<long>,   /* ID родительской учетной записи. */
        "parentEnabled":<bool>,       /* Родительская учетная запись: 1 — доступна, 0 — заблокирована. */
        "plan":<text>,        /* Название тарифного плана. */
        "enabled":<int>,  /* Состояние: 0 — заблокирована, 1 — активна. */
        "flags":<uint>,       /* Флаги - дублируют флаги из настроек тарифного плана. */
        "created":<unit>, /* Время создания учетной записи, UNIX-время. */
        "balance":<text>, /* Баланс (с валютой). */
        "daysCounter":<uint>, /* Счетчик дней. */
        "settings":{
            "balance":<double>,   /* Баланс. */
            "plan":{        /* Настройки тарифного плана. */
                "flags":<uint>,       /* Флаги тарифного плана (см. ниже). */
                "blockBalance":<int>, /* Минимальный баланс для активности учетной записи. */            
                "denyBalance":<int>,  /* Запрещающий баланс */
    
                "minDaysCounter":<int>,   /* Минимальное количество дней. Если остается меньше дней, учетная запись блокируется. */
                "historyPeriod":<uint>,   /* Период хранения сообщений. Если указан 0, период хранения не ограничен. */
                "currencyFormat":"<currency_format>", /* Формат валюты учетной записи. */  
                "services":{        /* Список услуг. */
                    <text>:{      /* Название услуги. */
                        "type":<int>,     /* Тип услуги: 1 — по требованию; 2 — периодическая */
                        "usage":<uint>,       /* Количество созданных ресурсов в текущей услуге */
                        "maxUsage":<int>, /* Максимальное количество ресурсов. */
                        "cost":<text>,        /* Таблица стоимости. */
                        "interval":<int>  /* Частота сброса: 0 — нет, 1 — ежечасно, 2 — ежедневно, 3 — еженедельно, 4 — ежемесячно.*/
                        "descr":"<text>"    /* Описание тарифицируемой услуги. */ 
                    }
                }
            },
            "personal":{        /* Настройки учетной записи (персональные). */
                ...         /* Имеет тот же формат, что и настройки тарифного плана. */
            },
            "combined":{        /* Комбинированные настройки, состоящие из настроек тарифного плана и учетной записи. */
                ...         /* Имеет тот же формат, что и настройки тарифного плана. */
            }
        },
        "siteAccess":{
                "<service_name>":"<dns_name>",      /* Где ключ — это название услуги, а значение — DNS-имя */
                ...
                 /* При использовании параметра "type=8" (см. выше) объект включает следующую дополнительную информацию.*/
                "<service_name>": {
                    "n":"<dns_name>", /* Где значение — это DNS-имя. */
                    "tt":"<template_type>", /* Где значение — это тип шаблона сайта (wialon_web, cms_manager.) */
                    "b":"<branch>", /* Ветка сайта (v1311, master, develop,v1408). */
                    "sp":<int>, /* SSL-порт. */
                    "force_https":"<force_https>", /* Пользовательское свойство сайта "force_https". */
                    "ignore_in_cms_login_as":"<ignore_in_cms_login_as>" /* Пользовательское свойство сайта "ignore_in_cms_login_as". */
                }
                ...
        },
        "serviceKeys":{ /* Внешние поставщики карт. */            "name":"<text>",  /* Название ключа карты.*/
                "type":<int>,         /* Тип ключа. */
                "provider":"<text>" /* Название поставщика карт. */
        },
        "managable":<int>,    /* Разрешить управление указанной в запросе учетной записью: 1 — да, 0 — нет. */
        "dealerRights":<int>, /* Разрешить использование дилерских прав для тарифного плана указанной учетной записи: 0 — нет, 1 — да. */
        "subPlans":[<text>]   /* Массив подчиненных тарифных планов. */
    }
    
    

    Ответ для нескольких учетных записей имеет следующую структуру:

    Copied!
    {
        "<account_id1>": {  /* ID запрошенной учетной записи. */
            ...                 /* Информация об учетной записи (см. выше). */
        },
        "<account_id2>": {  /* ID запрошенной учетной записи. */
            ...                 /* Информация об учетной записи (см. выше). */
        },
        ...
    }
    

    Типы ключей услуг

    Тип Описание
    0x01 Защищенный ключ (ключ Gurtam).
    0x02 Ключ маршрутизации.
    0x04 Ключ геокодирования.
    0x08 Ключ матрицы расстояний.
    0x10 Ключ тайлов карт.

    Флаги учетной записи

    Флаг Описание
    0x01 Блокировать пользователей, если баланс ниже порога блокировки.
    0x02 Запретить вход в систему и заблокировать учетную запись, если баланс меньше порога блокировки.
    0x20 Уменьшать количество дней в счетчике дней и блокировать учетную запись, когда количество оставшихся дней достигает минимума.
    0x40 Переопределить флаги тарифного плана.
    0x04 Разрешить неизвестные услуги.

    Список услуг

    Услуга Тип Описание
    avl_resource периодическая Активирует раздел Учетные записи в CMS Manager; определяет количество и стоимость ресурсов и учетных записей.
    avl_retranslator периодическая Активирует раздел Ретрансляторы в CMS Manager и определяет разрешенное количество и стоимость ретрансляторов.
    avl_route периодическая Активирует модуль Маршруты. Включает вкладку Маршруты и связанные отчеты и уведомления.
    avl_unit периодическая Активирует раздел Объекты в CMS Manager и вкладку Объекты в системе мониторинга. Определяет стоимость и количество объектов.
    avl_unit_group периодическая Активирует раздел Группы объектов в CMS Manager и вкладку Объекты в системе мониторинга. Определяет стоимость и количество групп объектов.
    cms_manager по требованию Предоставляет доступ к CMS Manager.
    create_units по требованию Активирует кнопку создания объектов в разделе Объекты в CMS Manager и на вкладке Объекты в системе мониторинга.
    create_users по требованию Активирует кнопку создания пользователей в разделе Пользователи в CMS Manager и на вкладке Пользователи в системе мониторинга.
    create_unit_groups по требованию Активирует кнопку создания групп объектов в разделе Группы объектов в CMS Manager и на вкладке Группы объектов в системе мониторинга
    create_resources по требованию Активирует кнопку создания ресурсов и учетных записей в разделе Ресурсы в CMS Manager.
    custom_fields периодическая Активирует вкладку Произвольные поля в свойствах объектов, пользователей или групп. Определяет стоимость и количество (суммарно, по объектам разных типов) произвольных полей; не влияет на водителей и прицепы.
    custom_reports по требованию Активирует расширенные отчеты: отчеты по группам объектов, пользователям, водителям, прицепам, а также группам водителей и прицепов (кроме таблицы Журнал для пользователей и групп объектов). Работает в рамках модуля Отчеты.
    drivers периодическая Активирует модуль Водители и определяет стоимость и количество водителей. При отключении вкладка Водители не отображается, а упоминания о водителях исчезают из уведомлений, настроек пользователя и диалога SMS.
    driver_groups периодическая Определяет количество и стоимость групп водителей. Работает в рамках модуля Водители.
    email_notification по требованию Включает отправку уведомлений по email. Рекомендуемое ограничение — 10 отчетов в час (во избежание перегрузки сервера).
    email_report по требованию Включает отправку отчета по email (в рамках модуля Задания). Рекомендуемое ограничение — 10 отчетов в час (во избежание перегрузки сервера).
    google_service по требованию Активирует сервисы Google.
    import_export по требованию Активирует функции Импорт/Экспорт на сайтах мониторинга.
    jobs периодическая Активирует вкладку Задания. Определяет стоимость и разрешенное количество заданий.
    locator по требованию Активирует опцию Локатор в меню пользователя.
    messages по требованию Предоставляет доступ к вкладке Сообщения.
    net_access (устарело) по требованию Разрешает аутентификацию через сервисный коннектор в Wialon Pro.
    notifications периодическая Активирует вкладку Уведомления и определяет стоимость и разрешенное количество уведомлений.
    orders периодическая Активирует доступ к приложению Логистика и позволяет запускать отчет Заявки по объектам и водителям в системе мониторинга.
    pois (устарело) периодическая Активирует панель POI и определяет стоимость и разрешенное количество POI.
    reports по требованию Активирует модуль Отчеты и определяет стоимость и разрешенное количество шаблонов отчетов. При отключении исчезают связанные задания и уведомления, а детектор поездок не может быть использован.
    retranslator_units периодическая Определяет количество доступных объектов, привязанных к активированным ретрансляторам.
    rounds периодическая Определяет количество разрешенных рейсов и их стоимость (в рамках модуля Маршруты).
    route_schedules периодическая Определяет количество разрешенных расписаний и их стоимость (в рамках модуля Маршруты).
    sdk по требованию Предоставляет доступ к Apps.
    service_intervals периодическая Определяет стоимость и количество интервалов техобслуживания. При активации во вкладке свойств объекта появляется вкладка Интервалы техобслуживания. Позволяет регистрировать события типа Техобслуживание, запускать отчеты и получать уведомления о техобслуживании.
    sms по требованию Определяет разрешенное количество SMS-сообщений и их стоимость.
    tacho по требованию Активирует таблицы Активность водителя и Нарушения в отчетах по водителям.
    storage_user периодическая Активирует вкладку Пользователи и определяет стоимость и количество пользователей.
    trailers периодическая Активирует вкладку Прицепы и определяет стоимость и количество прицепов.
    trailer_groups периодическая Определяет количество и стоимость прицепов; работает в рамках модуля Прицепы.
    unit_commands периодическая Активирует вкладку Команды в свойствах объекта. Определяет количество (для всех объектов в сумме) и стоимость команд.
    unit_sensors периодическая Определяет количество датчиков (рассчитывается для всех объектов в сумме) и их стоимость.
    user_notifications периодическая Включает получение информационных сообщений от администратора сервиса.
    Wialon_activex (устарело) по требованию Предоставляет удаленный доступ к системе через SDK, ActiveX.
    wialon_mobile (устарело) по требованию Активирует доступ к приложению для Android и iOS.
    wialon_mobile2 по требованию Активирует доступ к приложению для Android и iOS. Требуется включенная услуга wialon_mobile.
    wialon_sdk по требованию Предоставляет удаленный доступ к системе через SDK.
    zones_library периодическая Активирует модуль Геозоны и определяет стоимость и количество геозон. При отключении вкладка Геозоны не отображается, а любое упоминание о геозонах исчезает из отчетов и настроек пользователя.
    zone_groups периодическая Активирует группы геозон.
    AgroService (устарело) Тип Описание
    agroplots периодическая Поля
    agroplotgroups периодическая Группы полей
    agrocrops периодическая Культуры
    agromachines периодическая Сельхозтехника
    agroequipments периодическая Оборудование
    agrocultivationtypes периодическая Типы обработки

    Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.

    Сообщить об ошибке

    Ваше сообщение отправлено. Спасибо!

    Произошла ошибка при отправке формы

    Скачать файл PDF
    Скачать документ Word

    Смотрите также