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

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

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

Для получения табличных данных выполните 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
        } ]
    }
}