Получение непросмотренных результатов - qwep-ru/userapi GitHub Wiki

POST /search/updates

Позволяет получить порцию готовых и еще непросмотренных результатов при использовании метода поиска с type=1.

Заголовки:

  • Authorization: Bearer TOKEN

Параметры:

  • searchId — ID поиска (формируется в результате запроса на поиск), UUID
  • flatView — возвращать результаты в одном массиве, boolean (по умолчанию результаты находятся в массивах, разделенных по аккаунтам = false)
  • sorts — массив сортировок
    • type — тип, items/clarifications, string, по умолчанию: items
    • sort — поле сортировки, значения для items: id, price, quantity, article, company, vendor_name, part_name, значения для clarifications: id, article, company, vendor_name, part_name, по умолчанию: id
    • order — порядок сортировки: asc/desc, string, по умолчанию: asc

Ответ:

  • searchId — уникальный ID поиска, UUID
  • finished — статус поиска (закончен или нет), boolean
  • results — результаты поиска
    • accountId — ID аккаунта, integer
    • vendorId — ID поставщика
    • branchId — ID филиала (опционально)
    • clarifications — уточнения
      • article — артикул форматированный, text
      • clarificationId — ID уточнения, UUID
      • brand — Название компании, text
      • notes — доп. информация, text
      • photo — URL на фотографию, text
      • title — наименование, text
    • items — результаты
      • itemId — ID результата (используется при покупке)
      • article — артикул форматированный, text
      • city — ID города (если определился по складу)
      • brand — Название компании, text
      • delivery — срок поставки, text
      • fromClarification — ID раскрытого уточнения (если это результат раскрытия уточнения), UUID
      • notes — доп. информация, text
      • originalArticle — артикул оригинальный (как на сайте поставщика), text
      • photo — URL на фотографию, text
      • price — цена
        • Value — значение, float
        • Currency — валюта, text
        • Formatted — форматированный вывод цены, text
      • quantity — доступное количество
        • Value — значение, integer
        • Sign — знак >,<,=, text
        • Unit — единица измерения, text
        • Multiplicity — кратность товара, integer
        • Formatted — форматированный вывод, text
      • info — характеристики поставки
        • supplyPercent — процент успешных поставок, integer
        • isMarkdown — уцененный товар, boolean
        • isRefundAvailable — возможность возврата, boolean
        • refundDescription — условия возврата, text
        • isUsed — Б/У товар, boolean
        • vendorRating — рейтинг поставщика (от 1 до 5), integer
        • isDealerWarehouse — признак дилерского склада, boolean
      • status — статус товара, text
      • subway — название метро, text
      • title — наименование, text
      • warehouse — склад, text

Пример:

Запрос:

POST https://userapi.qwep.ru/search/updates?json HTTP/1.1
Authorization: Bearer TPYDICJIDU883JXCUIA19IUGPP

{
	"Request": {
		"RequestData": {
			"searchId": "771ce6e7-971a-47f2-a191-075eb584b5b1",
			"sorts":[
				{"type": "items", "sort":"price", "order":"asc"}
			]
		}
	}
}

Ответ:

{
	"Response": {
		"entity": {
			"searchId": "771ce6e7-971a-47f2-a191-075eb584b5b1",
			"finished": true,
			"results": [
				{
					"accountId": 14,
					"vendorId": "b4cc36d8-edd5-40a7-ad58-cdc155e4b6ed",
					"branchId": null,
					"clarifications": [
						{
							"clarificationId": "a59b28f4-c7e8-4006-be4b-d24225ea85de",
							"brand": "Febi",
							"article": "01244",
							"title": "Шайба колеса (C20.5/74361) L=8mm d(внутр)=20.5mm d(нар)=34mm BPW. Iveco. Mercedes. MAN. Evobus",
							"photo": "",
							"notes": ""
						},
						{
							"clarificationId": "9c84c417-3f2c-416d-bbf6-f5ea7f4f6b3d",
							"brand": "Metalcaucho",
							"article": "01244",
							"title": "К-КТ ПЫЛЬНИКА РУЛЕВОЙ SMART",
							"photo": "",
							"notes": ""
						},
						{
							"clarificationId": "c4592458-2c59-46e9-8d13-d95fe96f4206",
							"brand": "Walker",
							"article": "01244",
							"title": "",
							"photo": "",
							"notes": ""
						}
					],
					"items": [],
					"errors": [],
					"stats": {
						"timings": {
							"vendor": {
								"venMin": "0.1659",
								"venMax": "0.1659",
								"venAvg": "0.1659",
								"venCount": "1"
							},
							"api": {
								"apiMin": "0.6079",
								"apiMax": "0.6079",
								"apiAvg": "0.6079",
								"apiCount": "1"
							}
						},
						"counts": {
							"clarifications": 30,
							"items": 0,
							"errors": 0
						}
					}
				}
			],
			"type": 0
		},
		"errors": [],
		"warnings": []
	}
}