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

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

2. HTTP методы

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

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

POST запрос по URL: https://apimarket.parserdata.ru/api/v2/reviews/ В теле запроса необходимо передать список ссылок на товары, по которым необходимо получить данные. Ссылки передаются параметром link в массиве products.

Пример передачи 1 { "products": [ {"link": "https://www.wildberries.ru/catalog/59376900/detail.aspx"}, {"link": "https://www.wildberries.ru/catalog/143892937/detail.aspx"} ] }

Пример передачи 2 Для дополнительной идентификации переданных товаров, возможно передать внутренний код или любые другие дополнительные данные вместе с товаром в параметре custom_fields. { "products": [ {"link": "https://www.wildberries.ru/catalog/59376900/detail.aspx", "custom_fields": {"your_option": "your value"}}, {"link": "https://www.wildberries.ru/catalog/143892937/detail.aspx", "custom_fields": {"your_option_2": "your value_2"}} ] }

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

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

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

Возможные статусы: WAITING_DATA_PROCESSING – ожидание обработки данных DATA_PROCESSING – обработка данных WAITING_PARSING – ожидание парсинга PARSING - парсинг OK – завершено ERROR - ошибка

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

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

Пример ответа { "count": 2, "next": null, "previous": null, "results": [ { "domain": "wildberries.ru", "link": "https://www.wildberries.ru/catalog/59376900/detail.aspx", "custom_fields": {}, "status": "OK", "reviews": [ { "text": "Текст отзыва_1", "rating": 5, "username": "Имя", "created_at": "2023-10-08T12:45:29Z", "updated_at": "2023-10-08T19:22:20Z" }, { "text": "Текст отзыва_2", "rating": 4, "username": "Имя", "created_at": "2023-09-26T17:43:16Z", "updated_at": "2023-09-29T09:13:56Z" }, { "text": "Текст отзыва_3", "rating": 3, "username": "Имя", "created_at": "2023-07-24T10:04:05Z", "updated_at": "2023-08-17T11:46:27.105339596Z" } ] }, { "domain": "wildberries.ru", "link": "https://www.wildberries.ru/catalog/143892937/detail.aspx", "custom_fields": {}, "status": "OK", "reviews": [ { "text": "Текст отзыва_1", "rating": 1, "username": "Имя", "created_at": "2023-09-23T05:19:11Z", "updated_at": "2023-10-09T09:56:31Z" }, { "text": "Текст отзыва_2", "rating": 2, "username": "Имя", "created_at": "2023-09-22T18:08:45Z", "updated_at": "2023-10-01T18:43:34Z" }, { "text": "Текст отзыва_3", "rating": 3, "username": "Имя", "created_at": "2023-09-17T08:52:29Z", "updated_at": "2023-09-29T11:25:13Z" } ] } ], "status": "OK" }