# Активность пользователя

Открытый метод, отдающий статистику за последние 12 месяцев. Доступен только платным пользователям.

Бесплатный пользователь видит только статистику активности только своего аккаунта.

Счетчик - возвращает число дней в месяце, в которые осуществлялась активность.

## Структура URL

HTTP метод: GET BaseUrl/v1.0/activities/statistics/\{atiId}/year

### Список параметров

| Название | Описание                                                                                   | Способ передачи параметра | Обязательный |
| :------- | :----------------------------------------------------------------------------------------- | :------------------------ | :----------- |
| AtiID    | AtiID фирмы, для которой необходимо получить статистику активности за последние 12 месяцев | URL                       | Да           |

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

<a id="get-v1.0-activities-statistics-{atiId}-year"></a>

Получить статистику фирмы за год

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.0/activities/statistics/string/year' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/useractivity.openapi.json)

**Пример ответа (200)**

```json
{
  "atiId": "1054756",
  "statisticItems": {
    "add_forum_msg": {
      "stats": {
        "2018-06-01T00:00:00": 3,
        "2018-07-01T00:00:00": 3,
        "2018-09-01T00:00:00": 1,
        "2018-10-01T00:00:00": 2,
        "2019-02-01T00:00:00": 1,
        "2019-04-01T00:00:00": 2,
        "2019-05-01T00:00:00": 1
      },
      "zone": 64
    },
    "add_load": {
      "stats": {
        "2018-06-01T00:00:00": 2,
        "2019-04-01T00:00:00": 1
      },
      "zone": 16
    },
    "add_truck": {
      "stats": {
        "2018-06-01T00:00:00": 2,
        "2018-09-01T00:00:00": 1,
        "2018-11-01T00:00:00": 1,
        "2019-02-01T00:00:00": 1
      },
      "zone": 8
    },
    "auction_participated": {
      "stats": {},
      "zone": 32768
    },
    "auction_won": {
      "stats": {},
      "zone": 65536
    },
    "deals_declined": {
      "stats": {},
      "zone": 8192
    },
    "deals_declined_by_me": {
      "stats": {},
      "zone": 4096
    },
    "deals_finished": {
      "stats": {},
      "zone": 512
    },
    "exclusive_loads_count": {
      "stats": {},
      "zone": 262144
    },
    "firm_participations_count": {
      "stats": {
        "2019-04-01T00:00:00": 2,
        "2019-05-01T00:00:00": 2
      },
      "zone": 1048576
    },
    "forum": {
      "stats": {
        "2018-05-01T00:00:00": 9,
        "2018-06-01T00:00:00": 15,
        "2018-07-01T00:00:00": 6,
        "2018-08-01T00:00:00": 6,
        "2018-09-01T00:00:00": 8,
        "2018-10-01T00:00:00": 9,
        "2018-11-01T00:00:00": 6,
        "2018-12-01T00:00:00": 6,
        "2019-01-01T00:00:00": 2,
        "2019-02-01T00:00:00": 4,
        "2019-03-01T00:00:00": 3,
        "2019-04-01T00:00:00": 12,
        "2019-05-01T00:00:00": 2
      },
      "zone": 32
    },
    "load_search": {
      "stats": {
        "2018-06-01T00:00:00": 10,
        "2018-07-01T00:00:00": 4,
        "2018-08-01T00:00:00": 7,
        "2018-09-01T00:00:00": 7,
        "2018-10-01T00:00:00": 5,
        "2018-11-01T00:00:00": 4,
        "2018-12-01T00:00:00": 5,
        "2019-02-01T00:00:00": 5,
        "2019-03-01T00:00:00": 7,
        "2019-04-01T00:00:00": 3
      },
      "zone": 4
    },
    "loads_count": {
      "stats": {},
      "zone": 131072
    },
    "other": {
      "stats": {
        "2018-05-01T00:00:00": 13,
        "2018-06-01T00:00:00": 18,
        "2018-07-01T00:00:00": 14,
        "2018-08-01T00:00:00": 13,
        "2018-09-01T00:00:00": 11,
        "2018-10-01T00:00:00": 15,
        "2018-11-01T00:00:00": 21,
        "2018-12-01T00:00:00": 15,
        "2019-01-01T00:00:00": 9,
        "2019-02-01T00:00:00": 16,
        "2019-03-01T00:00:00": 12,
        "2019-04-01T00:00:00": 17,
        "2019-05-01T00:00:00": 6
      },
      "zone": 1
    },
    "own_auction_finished": {
      "stats": {},
      "zone": 16384
    },
    "own_deals_declined": {
      "stats": {},
      "zone": 2048
    },
    "own_deals_declined_by_me": {
      "stats": {},
      "zone": 1024
    },
    "own_deals_finished": {
      "stats": {},
      "zone": 256
    },
    "tender": {
      "stats": {
        "2018-05-01T00:00:00": 3,
        "2018-06-01T00:00:00": 2,
        "2018-07-01T00:00:00": 3,
        "2018-08-01T00:00:00": 1,
        "2018-09-01T00:00:00": 3,
        "2018-10-01T00:00:00": 3,
        "2018-11-01T00:00:00": 3,
        "2018-12-01T00:00:00": 2,
        "2019-04-01T00:00:00": 1
      },
      "zone": 128
    },
    "truck_search": {
      "stats": {
        "2018-05-01T00:00:00": 2,
        "2018-06-01T00:00:00": 5,
        "2018-07-01T00:00:00": 2,
        "2018-08-01T00:00:00": 3,
        "2018-09-01T00:00:00": 2,
        "2018-10-01T00:00:00": 1,
        "2018-11-01T00:00:00": 4,
        "2018-12-01T00:00:00": 2,
        "2019-03-01T00:00:00": 1
      },
      "zone": 2
    },
    "users_count_on_firm_boards": {
      "stats": {
        "2019-04-01T00:00:00": 0,
        "2019-05-01T00:00:00": 0
      },
      "zone": 524288
    }
  }
}
```

**Пример ответа (401)**

```json
{
  "Code": 401,
  "Message": "Unauthorized"
}
```

**Описание полей ответа**
- `Code` — Код ошибки
- `Message` — Текст ошибки


### Описание зон в ответе

| Зона          | Название зоны                | Описание                                                                   |
| :------------ | :--------------------------- | :------------------------------------------------------------------------- |
| Zone 1        | "other"                      | Заход на сайт                                                              |
| Zone 2        | "truck_search"               | Поиск машин                                                                |
| Zone 4        | "load_search"                | Поиск грузов                                                               |
| Zone 8        | "add_truck"                  | Размещение машин                                                           |
| Zone 16       | "add_load"                   | Размещение грузов                                                          |
| Zone 32       | "forum"                      | Просмотр форумов                                                           |
| Zone 64       | "add_forum_msg"              | Сообщение на форум                                                         |
| Zone 128      | "tender"                     | Поиск тендеров                                                             |
| Zone 256      | "own_deals_finished"         | Количество завершенных сделок, где пользователь - владелец                 |
| Zone 512      | "deals_finished"             | Количество завершенных сделок, где пользователь - участник                 |
| Zone 1024     | "own_deals_declined_by_me"   | Количество отказов от сделок, где пользователь - владелец                  |
| Zone 2048     | "own_deals_declined"         | Количество отказов от сделок, где пользователь - участник                  |
| Zone 4096     | "deals_declined_by_me"       | Количество отказов от сделок, где пользователь - перевозчик (он отказался) |
| Zone 8192     | "deals_declined"             | Количество отказов от сделок, где пользователь перевозчик (ему отказали)   |
| Zone 16384    | "own_auction_finished"       | Количество завершенных аукционов, где пользователь - владелец              |
| Zone 32768    | "auction_participated"       | Количество аукционов, в которых пользователь принимал участие              |
| Zone 65536    | "auction_won"                | Количество аукционов, в которых пользователь победил                       |
| Zone 131072   | "loads_count"                | Количество грузов, добавленных на общую площадку + на личные площадки      |
| Zone 262144   | "exclusive_loads_count"      | Количество грузов. добавленных только на личные площадки                   |
| Zone 524288   | "users_count_on_firm_boards" | Количество участников на площадках пользователя                            |
| Zone 1048576  | "firm_participations_count"  | Количество площадок, где фирма участвует                                   |
