Запрос отчета по событиям Fact

Owned by Inna Kabanova (Unlicensed)
Last updated: Apr 18, 2017
1 min read

Предназначен для определения статистики проездов зоны контроля транспортными средствами. Максимальный размер отчетного периода — 7 суток. Структура URL-запроса определяется форматом:

GET /api/v1/admin/stats/eventstore/fact\
   ?max-ts=<max-ts>
   &min-ts=<min-ts>\
   &min-ts-gap=<min-ts-gap>\
   &min-total-count=<min-total-count>

где

  • <max-ts> — отметка времени завершения отчетного периода, мкс от 01.01.1970 00:00 UTC. Опциональный параметр. Возможны значения в интервале [0; 2147476447000000]. По умолчанию определяется системным временем на момент обработки запроса.
  • <min-ts> — отметка времени начала отчетного периода, мкс (от 01.01.1970 00:00 UTC). Опциональный параметр. Возможны значения в интервале [0; 2147476447000000]. По умолчанию определяется как разность времени завершения отчетного периода и макс. размера отчетного периода в мкс.
  • <min-ts-gap> — мин. промежуток времени между последовательными событиями, с. Опциональный параметр. Возможны значения в интервале [0; 65535]. По умолчанию 10.
  • <min-total-count> — мин. количество проездов зоны контроля. Опциональный параметр. Возможны значения в интервале  [1; 65535]. По умолчанию 2.

Если структура URL-запроса соответствует требованиям, сервер, после успешной обработки, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: struct[]. Массив. Каждый элемент содержит статистику проездов транспортным средством зоны контроля. Элементы в порядке убывания значения total-count:

    1. "plate-text" :: char[]. Текст номера транспортного средства.

    2. "total-count" :: uint32_t. Количество проездов зоны контроля.

    3. "last-guid" :: char[37]. Глобальный идентификатор последнего события Fact.

    4. "last-datetime" :: uint32_t. Время регистрации изображения зоны контроля последнего события Fact, ISO8601.

    5. "last-ts" :: uint64_t.  Время регистрации изображения зоны контроля последнего события Fact, мкс (от 01.01.1970 00:00 UTC).

Пример тела ответа:

{
 "status": 200,
 "result":
 [
   {
     "plate-text": "ВВ4105АА",
     "total-count": 14,
     "last-guid": "69e86fa7-e1ad-4e68-96b7-b910f40bdb49",
     "last-datetime": "2016-06-14T10:52:53.520817+00:00",
     "last-ts": 100600200400
   }
 ]
}