IntegraçãoDados tabulares

Получение табличных данных

Табличные данные наиболее универсальны, на их основе можно построить любой отчет в разном разрезе.

Формат запроса #

Для получения табличных данных выполните GET-запрос:

GET https://content.mql5.com/api/v1/reports/website/{WEBSITE_ID}/table
 ?metrics=<string>
 &date_from=<unixtime>
 &date_to=<unixtime>
 &group=<string>
 &where=<array>
 &offset=<integer>
 &limit=<integer>
 &order=<string>

В качестве {WEBSITE_ID} укажите идентификатор сайта. Его можно получить в панели Finteza в разделе настроек сайта (поле "ID").

Параметры запроса #

Параметр

Тип

Описание

metrics *

string

Список метрик через запятую. Например, metrics=visits,events.

date_from *

unixtime

Начальная дата для запроса данных. Указывается в количестве секунд с 1970.01.01. Например, date_from=1549027860.

date_to *

unixtime

Конечная дата для запроса данных. Указывается в количестве секунд с 1970.01.01. Например, date_from=1549027860.

group *

string

Список полей для группировки данных через запятую.

where

array

Массив условий в виде ?where[ключ]=значение, где ключ – это имя поля, по которому будет осуществляться фильтрация. Для значения условия можно использовать операторы:

  • = (IS) – точное соответствие значению. Например, where[os]=windows означает, что будут возвращены только данные по пользователям с операционной системой Windows.
  • * (LIKE) – неточное соответствие значению. Например, where[device]=*mobile означает, что будут возвращены только данные по пользователям, чей тип устройств содержит "mobile".
  • ! (NOT) – несоответствие значению. Например, where[country]=*!ru означает, что будут возвращены только данные по пользователям не из России.

offset

integer

Позиция первого элемента списка, начиная с которого нужно получить данные. По умолчанию равен 0 – получение данных, начиная с самого нового (последнего) элемента.

limit

integer

Количество элементов списка, которые необходимо получить. По умолчанию равен 20.

order

string

Название поля, по которому будет выполнена сортировка. Чтобы выполнить обратную сортировку, укажите "-" перед названием поля, например, order=-visits.

* – обязательные параметры.

Пример запроса #

GET https://content.mql5.com/v1/reports/website/dxnnhxrwpcwsgwowveipxmslrznjfhzarp/table
 ?metrics=webvisits,events
 &group=ua_device,ua_device_model
 &where[os]=windows
 &where[device]=*mobile
 &where[country]=!ru
 &offset=0
 &limit=20
 &date_from=1549027860
 &date_to=1549632660
 &order=webvisits

Пример ответа #

{
    "data": {
        "offset": 0,
        "limit": 20,
        "date_from": 1549027860,
        "date_to": 1549632660,
        "where": {
            "os""windows",
            "device""*mobile",
            "country""!ru",
        },
        "order""webvisits",
        "items": [ {
            "ua_device""Desktop",
            "ua_device_model""Apple",
            "webvisits": 4205748,
            "events": 1247138
        }, {
            "ua_device""Mobile",
            "ua_device_model""Apple",
            "webvisits": 42050,
            "events": 1247
        }, {
            "ua_device""Tablet",
            "ua_device_model""Apple",
            "webvisits": 420,
            "events": 12
        } ]
    }
}