GET /user/offers/{category}/{offerID}/stats

Возвращает статистику просмотров по указанному объявлению.

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

POST https://apiauto.ru/1.0/user/offers/{category}/{offerID}/stats
? from=<string>
& to=<string>

category

Название категории ТС. Допустимые значения:

cars — легковые автомобили;
moto — мототранспорт;
trucks — коммерческий транспорт;
all — все категории ТС.

offerID

Идентификатор объявления, для которого необходимо получить статистику просмотров.

from*

Дата начала отсчета в формате YYYY-MM-DDдля получения статистики по дням.

to*

Дата окончания отсчета в формате YYYY-MM-DDдля получения статистики по дням.

* Обязательный параметр

Заголовки запроса

Заголовок	Описание
`x-dealer-id`	Идентификатор клиента. Используется для работы под учетной записью агентства.
`x-session-id`	Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login.

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

{
  "items": [
    {
      "offer_id": "{string}",
      "counters": [
        {
          "date": "{string}",
          "views": {integer},
          "phone_views": {integer}
        }
      ]
    }
  ],
  "status": "{string}"
}

items

Массив объектов со статистикой просмотров.

offer_id

Идентификатор объявления.

counters

Информация о количестве просмотров объявления и телефона в объявлении.

date

Дата, за которую отображается статистика.

views

Количество просмотров объявления за указанную дату.

phone_views

Количество просмотров телефона в объявлении за указанную дату.

status

Статус ответа.

Коды ответа

Код	Причина	Описание
200	OK	Успешный запрос.
400	BAD_REQUEST	Синтаксическая ошибка в запросе.
401	NO_AUTH	Не удалось авторизовать пользователя по переданным данным.
404	OFFER_NOT_FOUND	Объявление не найдено.
500	INTERNAL SERVER ERROR	Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/user/offers/trucks/15304953-96189649/stats?from=2018-06-25&to=2018-06-30' -H 'x-authorization: 2dtrer432...' -H 'Accept: application/json' -H 'x-session-id: 112_aoR02Tpv...'

Ответ:

HTTP/1.1 200 OK
Server: nginx
Date: Tue, 10 Jul 2018 15:19:41 GMT
Content-Type: application/json
Connection: keep-alive
                    
{
  "items": [
    {
      "offer_id": "15304953-96189649",
      "counters": [
        {
          "date": "2018-06-25",
          "views": 0,
          "phone_views": 0,
          "phone_calls": 0
        },
        {
          "date": "2018-06-26",
          "views": 0,
          "phone_views": 0,
          "phone_calls": 0
        },
        {
          "date": "2018-06-27",
          "views": 0,
          "phone_views": 0,
          "phone_calls": 0
        },
        {
          "date": "2018-06-28",
          "views": 1,
          "phone_views": 0,
          "phone_calls": 0
        },
        {
          "date": "2018-06-29",
          "views": 2,
          "phone_views": 0,
          "phone_calls": 0
        },
        {
          "date": "2018-06-30",
          "views": 0,
          "phone_views": 0,
          "phone_calls": 0
        }
      ]
    }
  ]
}

Была ли статья полезна?

DELETE /user/offers/{category}/{offerID}/products

GET /billing/schedules