GET /feeds/history
Возвращает историю загрузок прайс-листов.
Формат запроса
GET https://apiauto.ru/1.0/feeds/history
Заголовки запроса
|
Заголовок |
Описание |
|
|
Идентификатор клиента. Используется для работы под учетной записью агентства. |
|
|
Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login. |
Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.
Формат ответа
{
"feeds": [
{
"category": {
"section": {string},
"category": {string},
"truck_category": {string},
"moto_category": {string}
},
"settings": {
"source": {string},
"delete_sale": {boolean},
"leave_services": {boolean},
"leave_added_images": {boolean},
"is_active": {boolean}
},
"task": {
"id": {string},
"created_at": {string},
"finished_at": {string},
"type": {string},
"status": {string},
"settings": {
"internal_url": {string},
"settings": {
"source": {string},
"delete_sale": {boolean},
"leave_services": {boolean},
"leave_added_images": {boolean},
"is_active": {boolean}
}
},
"count_offers": {integer},
"count_errors": {integer},
"count_notices": {integer},
"count_offers_inserted": {integer},
"count_offers_updated": {integer},
"count_offers_deleted": {integer},
"count_offers_skipped": {integer},
"count_images": {integer},
"count_images_success": {integer},
"count_images_errors": {integer},
"count_success": {integer}
}
}
]
}
|
feeds |
Список настроек для прайс-листов. |
-
category
Информация о категории ТС.
-
section
Состояние транспортного средства.
Допустимые значения:
NEW— новое транспортное средство;USED— транспортное средство с пробегом (б/у).
category
Категория транспортного средства (ТС).
Допустимые значения:
CARS— легковой автомобиль;MOTO— мототранспорт;TRUCKS— коммерческий транспорт.
truck_category
Категория коммерческого транспорта.
Допустимые значения:
TRUCK— грузовик;LCV— легкий коммерческий транспорт;TRAILER— прицеп;SWAP_BODY— съемный кузов;BUS— автобус;ARTIC— седельный тягач;AGRICULTURAL— сельскохозяйственная;CONSTRUCTION— строительная;AUTOLOADER— автопогрузчик;CRANE— автокран;DREDGE— экскаватор;BULLDOZERS— бульдозер;CRANE_HYDRAULICS— самопогрузчик;MUNICIPAL— коммунальная.
moto_category
Категория мототранспорта.
Допустимые значения:
ATV— мотовездеход;MOTORCYCLE— мотоцикл;SCOOTERS— скутер;SNOWMOBILE— снегоход.
settings
Настройки прайс-листа.
-
source
Ссылка на загрузку прайс-листа.
delete_sale
Признак. Удалять объявления, которые были созданы вручную или отсутствует в прайс-листе.
leave_services
Признак. Не удалять услуги объявлений, если они не были переданы в прайс-листе.
leave_added_images
Признак. Не удалять загруженные вручную фотографии, если они не были переданы в прайс-листе.
is_active
Признак. Активна или нет загрузка данного прайс-листа.
task
Информация о задаче на ручную загрузку прайс-листа.
-
id
Идентификатор задачи на ручную загрузку прайс-листа.
created_at
Дата создания задачи в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00.
finished_at
Дата окончания задачи в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00.
type
Тип загрузки прайс-листа. Параметр не выводится при использовании ручной загрузки.
Допустимые значения:
AUTOMATIC— автоматическая;MANUAL— ручная.
status
Статус задачи на ручную загрузку прайс-листа.
Допустимые значения:
NEW— прайс-лист еще не загружен;PROCESSING— прайс-лист находится в обработке;SUCCESS— прайс-лист успешно загружен;FAILURE— ошибка загрузки.
-
settings
Настройки прайс-листа.
-
source
Ссылка на загрузку прайс-листа.
delete_sale
Признак. Удалять объявления, которые были созданы вручную или отсутствует в прайс-листе.
leave_services
Признак. Не удалять услуги объявлений, если они не были переданы в прайс-листе.
leave_added_images
Признак. Не удалять загруженные вручную фотографии, если они не были переданы в прайс-листе.
is_active
Признак. Активна или нет загрузка данного прайс-листа.
-
count_offers
Количество объявлений в прайс-листе.
count_errors
Количество объявлений с ошибками (объявления, которые не были обработаны).
count_notices
Количество объявлений с предупреждениями.
count_offers_inserted
Количество новых объявлений.
count_offers_updated
Количество обновленных объявлений.
count_offers_deleted
Количество удаленных объявлений.
count_offers_skipped
Количество необновленных объявлений.
count_images
Количество изображений в прайс-листе.
count_images_success
Количество успешно добавленных изображений.
count_images_errors
Количество незагруженных изображений.
count_success
Количество успешно обработанных объявлений.
-
Коды ответа
|
Код |
Причина |
Описание |
|
200 |
OK |
Успешный запрос. |
|
400 |
BAD_REQUEST |
Синтаксическая ошибка в запросе. |
|
401 |
NO_AUTH |
Не удалось авторизовать пользователя по переданным данным. |
|
500 |
INTERNAL SERVER ERROR |
Внутренняя ошибка сервера. |
Пример
Запрос:
curl -i -X GET 'https://apiauto.ru/1.0/feeds/history' -H 'x-authorization: 2dtrer432...' -H 'x-session-id: 112_aoR02Tpv...'Ответ:
HTTP/1.1 200 OK Server: nginx Date: Fri, 15 Jun 2018 13:30:59 GMT Content-Type: application/json Connection: keep-alive { "feeds": [ { "category": { "section": "USED", "category": "CARS", "truck_category": "TRUCK", "moto_category": "MOTORCYCLE" }, "settings": { "source": "https://example-url/feed", "delete_sale": true, "leave_services": true, "leave_added_images": true, "is_active": true }, "task": { "id": 0, "created_at": "2019-05-14T13:39:01.421Z", "finished_at": "2019-05-14T13:39:01.421Z", "type": "AUTOMATIC", "status": "NEW", "settings": { "internal_url": "https://example-url/feed", "settings": { "source": "https://example-url/feed", "delete_sale": true, "leave_services": true, "leave_added_images": true, "is_active": true } }, "count_offers": 0, "count_errors": 0, "count_notices": 0, "count_offers_inserted": 0, "count_offers_updated": 0, "count_offers_deleted": 0, "count_offers_skipped": 0, "count_images": 0, "count_images_success": 0, "count_images_errors": 0, "count_success": 0 } } ] }
Настройки прайс-листа.