Раскрытие уточнения - qwep-ru/userapi GitHub Wiki

POST /search

Заголовки:

• Authorization: Bearer TOKEN

!!! Параметр "clarification" устарел, используйте "clarificationId" !!!

Параметры:

• clarificationId — ID уточнения, UUID
• searchId — ID поиска, UUID
• flatView — возвращать результаты в одном массиве, boolean (по умолчанию результаты находятся в массивах, разделенных по аккаунтам = false)
• type — 0 или 1, тип взаимодействия:
  • 0 - синхронное, результаты возвращаются в ответе на этот же запрос (по умолчанию)
  • 1 - асинхронное, ответ возвращается сразу с выданным searchId, поиск запускается, результаты можно получить методами /search/results или /search/updates. Если задан Callback URL, то результаты отправляются еще и на URL пользователя (Callback URL задается по запросу, подробнее в разделе отправка данных на внешний ресурс), integer
• sorts — массив сортировок
  • type — тип, items/clarifications, string, по умолчанию: items
  • sort — поле сортировки, значения для items: id, price, quantity, article, vendor_name, part_name, значения для clarifications: id, article, vendor_name, part_name, по умолчанию: id
  • order — порядок сортировки: asc/desc, string, по умолчанию: asc

Ответ:

• searchId — уникальный ID поиска, по которому можно получить результаты с /search/results или /search/updates, UUID
• finished — статус поиска (закончен или нет), boolean
• results — результаты поиска
  • accountId — ID аккаунта, integer
  • vendorId — ID поставщика
  • branchId — ID филиала (опционально)
  • 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
    • status — статус товара, text
    • subway — название метро, text
    • title — наименование, text
    • type — тип записи (Item), text
    • warehouse — склад, text

Пример:

Запрос:

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

{
	"Request": {
		"RequestData": {
			"clarificationId": "a2a56842-df04-11e6-bf01-fe55135034f3",
                        "searchId": "f140a340-c363-4b1a-bebb-45e1c707abdc"
		}
	}
}

Ответ:

{
	"Response": {
		"entity": {
			"searchId": "9ea8c62f-5d56-4684-a14e-dd057d0a2006",
			"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": []
	}
}