1. Авторизация по ключу

Для передачи ключа, в запросе необходимо использовать HTTP заголовок с параметром Authorization. Authorization: Token xxxxxxxxxxxxxxxxxxxx

2. HTTP методы

POST - для создания таска GET - для получения информации

3. Создание таска на поиск карточек

POST запрос по URL: https://apimarket.parserdata.ru/task/search/ В теле запроса необходимо передать город мониторинга и список названий товаров: 1. Город передается параметром region_id (список городов). 2. Названия товаров передаются параметром product_name в массиве site_products.

Пример передачи товаров 1 Тело запроса с названиями товаров к которым необходимо найти верную модель, город мониторинга Москва: { "region_id":213, "site_products":[ {"product_name":"Xiaomi Dreame V11"}, {"product_name":"Xiaomi Dreame Ares"}, {"product_name":"Xiaomi Electric Scooter 1S"}, {"product_name":"Xiaomi Induction Home Water Sensor"}, {"product_name":"Xiaomi Jimmy JV51"}, {"product_name":"Xiaomi Jimmy JV71"}, {"product_name":"Xiaomi Mi Action Camera Handheld Gimbal"}, {"product_name":"Xiaomi Mi Air Purifier 2s"} ] }

Пример передачи товаров 2 Для дополнительной идентификации переданных товаров, возможно передать внутренний код или любые другие дополнительные данные вместе с товаром в параметре custom_field_1 (доступно до 5 custom_field по каждому товару). { "region_id":213, "site_products":[ {"product_name":"Xiaomi Dreame V11", "custom_field_1":"артикул 1", "custom_field_2":"код поставщика X"}, {"product_name":"Xiaomi Dreame Ares", "custom_field_1":"артикул 2", "custom_field_2":"код поставщика Y"}, {"product_name":"Xiaomi Electric Scooter 1S", "custom_field_1":"артикул 3", "custom_field_2":"код поставщика Z"}, {"product_name":"Xiaomi Induction Home Water Sensor"}, {"product_name":"Xiaomi Jimmy JV51"}, {"product_name":"Xiaomi Jimmy JV71"}, {"product_name":"Xiaomi Mi Action Camera Handheld Gimbal"}, {"product_name":"Xiaomi Mi Air Purifier 2s"} ] }

Пример ответа на успешный запрос созданного таска: { "task_id": 123 } где 123, номер созданного таска

4. Проверка статуса таска

GET запрос по URL: https://apimarket.parserdata.ru/task/TASK_ID/search/?page=1 где TASK_ID, номер созданного таска Пример ответа, во время парсинга: { "count": 0, "next": null, "previous": null, "results": [ ], "status": "PARSING" }

Возможные статусы: SAVE_PRODUCTS – подготовка IN_PROGRESS – отправка PARSING – парсинг DONE – завершено

5. Получение результатов по таску

Проверку статуса у таска, рекомендуем проводить с задержкой в 1 секунду. При смене статуса на DONE, в теле ответа выводятся результаты, где: count – количество переданных названий товаров next – следующая страница с результатами (на одной странице 500 товаров) previous – предыдущая страница с результатами (если значение на странице null, вы находитесь на последней странице) results – массив с полученными данными search - даные из поиска (если параметр равен null, карточка не найдена) status – статус задания

Пример ответа с данными после парсинга: { "count": 8, "next": "https://apimarket.parserdata.ru/task/TASK_ID/search/?page=2", "previous": null, "results": [{ "product_name": "Xiaomi Dreame V11", "region_id": 213, "region_name": "Москва", "custom_fields": { "custom_field_1": "артикул 1", "custom_field_2": "код поставщика X", "custom_field_3": null, "custom_field_4": null, "custom_field_5": null }, "search": { "model": "Пылесос Xiaomi Dreame V11", "model_id": "673192011", "link": ""} }, { "product_name": "Xiaomi Dreame Ares", "region_id": 213, "region_name": "Москва", "custom_fields": { "custom_field_1": "артикул 2", "custom_field_2": "код поставщика Y", "custom_field_3": null, "custom_field_4": null, "custom_field_5": null }, "search": null }, { "product_name": "Xiaomi Electric Scooter 1S", "region_id": 213, "region_name": "Москва", "custom_fields": { "custom_field_1": "артикул 3", "custom_field_2": "код поставщика Z", "custom_field_3": null, "custom_field_4": null, "custom_field_5": null }, "search": { "model": "Электросамокат Xiaomi Mi Electric Scooter 1S", "model_id": "665682001", "link": ""} }, { "product_name": "Xiaomi Induction Home Water Sensor", "region_id": 213, "region_name": "Москва", "custom_fields": null, "search": null }, { "product_name": "Xiaomi Jimmy JV51", "region_id": 213, "region_name": "Москва", "custom_fields": null, "search": { "model": "Пылесос Xiaomi Jimmy JV51", "model_id": "197642701", "link": ""} }, { "product_name": "Xiaomi Jimmy JV71", "region_id": 213, "region_name": "Москва", "custom_fields": null, "search": { "model": "Пылесос Xiaomi Jimmy JV71", "model_id": "442422588", "link": ""} }, { "product_name": "Xiaomi Mi Action Camera Handheld Gimbal", "region_id": 213, "region_name": "Москва", "custom_fields": null, "search": { "model": "Электрический стабилизатор для экшн-камеры Xiaomi Mi Action Camera Handheld Gimbal", "model_id": "330530013", "link": ""} }, { "product_name": "Xiaomi Mi Air Purifier 2s", "region_id": 213, "region_name": "Москва", "custom_fields": null, "search": { "model": "Очиститель воздуха Xiaomi Mi Air Purifier 2S (FJY4020GL)", "model_id": "1877407507", "link": ""} } ], "status": "DONE" }