Метод "подсказка" (GetSearchSuggestV3)
Аналогично GetSearchSuggest, но с дополнительным параметром type_request, login и password
GetSearchSuggestV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
search_text | string | да | произвольная строка поиска |
row_count | string | да | сколько максимально записей возвращать |
type_request | string | да | тип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам) |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
terms | string | да | поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений. |
table | Массив GetSearchSuggestItem[] | да | массив данных |
GetSearchSuggestItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3?login={login}&password={password}&search_text=Колодки BMW&row_count=3&type_request=0&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=колодки BMW" --data-urlencode "row_count=3" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3
Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 50, // сколько строк вернулось
"terms": "колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки",
"table":
[
{
"class_man": "BMW", // производитель
"logopath": "https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "34116769951", // номер
"class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование
"code_cat": 115835062, // внутренний уникальный код позиции
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] , // массив ссылок на превью фото запчасти 60px на 60px
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
},
{
...
}
]
}
Метод "результат поиска" (GetSearchResultV3)
Аналогично GetSearchResult, но с дополнительными параметрами search_text и type_request
GetSearchResultV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
code_region | string | да | code_region из метода GetRegions |
search_text | string | да | произвольная строка поиска |
partnumber | string | да | номер запчасти |
class_man | string | да | производитель запчасти |
row_count | string | да | ограничение по кол-ву строк. по умолчанию 100, максимум 500 |
type_request | string | да | тип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам), 4 - любые предложения только по запрошенному номеру, 5 - новые только по запрошенному номеру |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр Тип Обязательный Описание error string да если пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.row_count int да сколько строк вернулось terms strings да "колодок;колодку;колодкою;
колодкой;
колодке;колодках;колодками;
колодкам;
колодка;колодки;колодки"
поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.class_man string да производитель запрашиваемой запчасти logopath string да ссылка на превью логотипа производителя 30px на 30px запрашиваемой запчасти partnumber string да номер запрашиваемой запчасти class_cat string да наименование запрашиваемой запчасти imagepath string да ссылка на превью фото запчасти 60px на 60px**** запрашиваемой запчасти imagepathV2 string[] да массив ссылок на превью фото запчасти 60px на 60px**** запрашиваемой запчасти code_cat int да внутренний уникальный код позиции запрашиваемой запчасти class_cur string да валюта (например, белорусские рубли) запрашиваемой запчасти price_count_instock int да количество предложений в наличии запрашиваемой запчасти price_min_instock decimal да минимальная цена среди предложений в наличии запрашиваемой запчасти price_avg_instock decimal да средняя цена среди предложений в наличии запрашиваемой запчасти price_max_instock decimal да максимальная цена среди предложений в наличии запрашиваемой запчасти price_count_order int да количество предложений под заказ запрашиваемой запчасти price_min_order decimal да минимальная цена среди предложений под заказ запрашиваемой запчасти price_avg_order decimal да средняя цена среди предложений под заказ запрашиваемой запчасти price_max_order decimal да максимальная цена среди предложений под заказ запрашиваемой запчасти code_man int да внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) запрашиваемой запчасти table Массив GetSearchResultItem[] да Массив данных
GetSearchResultItem:
Параметр Тип Обязательный Описание code_doc_b long да внутренний уникальный код предложения (нужно передавать в GetSearchResultOne) code_cat int да внутренний уникальный код позиции descr_type_search string да тип предложения class_man string да производитель logopath string да ссылка на превью логотипа производителя 30px на 30px partnumber string да номер class_cat string да наименование imagepath string да ссылка на превью фото запчасти 60px на 60px**** imagepathV2 string[] да массив ссылок на превью фото запчасти 60px на 60px**** qty string да кол-во, текст! apply string да условия продажи, если указаны продавцом min_sum_order decimal да минимальная сумма заказа, если указана продавцом descr_min_sum_order string да минимальная сумма заказа текстом, если указана продавцом shipment string да условия доставки courier bool да доставка курьером: если true - есть, если false - нет instockV2 bool да наличие на складе wholesaleV2 bool да тип цены (для юр. лиц и ИП, если true, или для розницы, если false) localV2 bool да если true, то предложение локальное, если false, то из другого региона priceV2 decimal да цена (в той валюте, в которой смотрел покупатель) price_date DateTime да дата публикации descr_priceV2 string да цена текстом с коротким обозначением валюты, в которой смотрел покупатель price_orig decimal да цена (в той валюте, в которой публиковал продавец) descr_price_orig string да цена текстом (в той валюте, в которой публиковал продавец) descr_type_price string да отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто) descr_qty string да подпись под кол-вом class_user string да наименование продавца descr_rating_count string да сколько отзывов текстом rating int да рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд descr_address string да местоположение phone1 string да телефон order_text string да три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) user_key string да "ключ" продавца, с помощью которого вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) addr_map_geo1 double да широта (координаты местонахождения продавца) addr_map_geo2 double да долгота (координаты местонахождения продавца) type_search int да 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценка, usedV2 bool да тип предложения: false – обычное предложение, true – б/у и уценка qtyV2 int да количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») qty_max int да максимально допустимое количество для заказа по конкретному предложению продавца descr_qtyV2 string да количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» delivery_days int да количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) descr_delivery string да срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») type_user string да тип пользователя* type_user2 string да тип пользователя 2** type_price string да тип прайс-листа*** descr_price_date string да давности обновления прайс-листа pack int да кратность (упаковка) числом descr_pack string да кратность (упаковка) текстом type_chain_search int да основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений noorig bool да если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное code_man int да внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) location string да город и метро продавца descr_rating_year_count string да сколько отзывов за год (текстом) rating_year int да рейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд descr_rating_total_count string да сколько отзывов за всё время (текстом) rating_total int да рейтинг за всё время: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&code_region=11135&row_count=100&type_request=0&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=Колодки Nissan" --data-urlencode "partnumber=MR245368" --data-urlencode "class_man=MITSUBISHI" --data-urlencode "code_region=11135" --data-urlencode "row_count=100" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3
Ответ
{
"error":"", // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"class_man": "MITSUBISHI", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"table": [ {
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"code_cat": 1116901944 // внутренний уникальный код позиции
"descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе
"wholesaleV2": true, // тип цены (для юр. лиц и ИП, если true, или для розницы, если false)
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"class_user": "Repart", // наименование продавца
"descr_rating_count": "5 отзывов", // сколько отзывов
"rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_address": "Москва, м. Юго-Западная", // местоположение
"phone1": "8(926)103-45-33", // телефон
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"type_search": 10, // 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценке
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней", // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"type_user": "UBNAIRWPYTOGM234", // тип пользователя
"type_user2": "GCKMNZ", // тип пользователя 2
"type_price": "RMP", // тип прайс-листа
"descr_price_date":"Сегодня 13ч. назад" // текстовое описание давности обновления прайс-листа
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"location": ""Москва, м. Юго-Западная" // город и метро продавца
"descr_rating_year_count": "15 отзывов", // сколько отзывов за год
"rating_year": 3, // рейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_rating_total_count": "40 отзывов", // сколько отзывов за всё время
"rating_total": 3, // рейтинг за всё время: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
}
{
...
}
]
}
Метод "одно предложение" (GetSearchResultOneV2)
GetSearchResultOneV2
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | нет | e-mail, указанный при регистрации на сайте ZZap (может быть пустым) |
password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
code_doc_b | string | да | получен в методе GetSearchResult/GetSearchResultV2/GetSearchResultV3 |
code_region | string | да | code_region из метода GetRegions |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр Тип Обязательный Описание error string да если пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.code_doc_b long да внутренний уникальный код предложения code_cat int да внутренний уникальный код код позиции class_man string да производитель logopath string да ссылка на превью логотипа производителя 30px на 30px partnumber string да номер class_cat string да наименование imagepath string да ссылка на превью фото запчасти 60px на 60px**** imagepathV2 string[] да массив ссылок на превью фото запчасти 60px на 60px**** qty string да кол-во, текст! apply string да условия продажи, если указаны продавцом min_sum_order decimal да минимальная сумма заказа, если указана продавцом descr_min_sum_order string да минимальная сумма заказа текстом, если указана продавцом shipment string да условия доставк courier bool да доставка курьером: если true - есть, если false - нет instockV2 bool да наличие на складе wholesaleV2 bool да тип цены (для юр. лиц и ИП, если true, или для розницы, если false) localV2 bool да если true, то предложение локальное, если false, то из другого региона priceV2 decimal да цена (в той валюте, в которой смотрел покупатель) priceV3 decimal да цена в рублях price_date DateTime да дата публикации descr_priceV2 string да цена текстом с коротким обозначением валюты, в которой смотрел покупатель descr_priceV3 string да цена в рублях price_orig decimal да цена (в той валюте, в которой публиковал продавец) descr_price_orig string да цена текстом (в той валюте, в которой публиковал продавец) descr_type_price string да отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто) descr_qty string да подпись под кол-вом class_user string да наименование продавца descr_rating_count string да сколько отзывов текстом rating int да рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд descr_address string да местоположение phone1 string да телефон 1 phone2 string да телефон 2 comment string да часы работы + краткая информация о продавце (желательно обрабатывать, если встречается) commentV2 string да краткая информация о продавце info string да когда началось сотрудничество с ZZap order_text string да три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) addr_map_geo1 double да широта (координаты местонахождения продавца) addr_map_geo2 double да долгота (координаты местонахождения продавца) user_key string да "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) usedV2 bool да тип предложения: false – обычное предложение, true – б/у и уценка accept_messages bool да готов ли продавец переписываться с покупателями: true - готов, false - не готов qtyV2 int да количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») qty_max int да максимально допустимое количество для заказа по конкретному предложению продавца descr_qtyV2 string да количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» delivery_days int да количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) descr_delivery string да срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») work_time string да время работы продавца type_user string да тип пользователя* type_user2 string да тип пользователя 2** type_price string да тип прайс-листа*** telegram string да номер в telegram whatsapp string да номер в whatsapp viber string да номер в viber pack int да кратность (упаковка) числом descr_pack string да кратность (упаковка) текстом type_chain_search int да основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений noorig bool да если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное code_man int да внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) seller_addressV2 string да полный адрес продавца seller_location string да город и метро продавца descr_rating_year_count string да сколько отзывов за год (текстом) rating_year int да рейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд descr_rating_total_count string да сколько отзывов за всё время (текстом) rating_total int да рейтинг за всё время: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2?login={login}&password={password}&code_doc_b=208098711507246&code_region=11135&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "code_region=11135" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2
Ответ
{
"error": "", // если пусто, ошибок нет
"code_doc_b": 208098711507246, // внутренний уникальный код предложения
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе
"wholesaleV2": true, // тип цены (для юр. лиц и ИП, если true, или для розницы, если false)
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"priceV3": 1000.00, // цена в рублях
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р." // цена текстом (в той валюте, в которой смотрел покупатель)
"descr_priceV3": "1000р." // цена текстом в рублях
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"class_user": "Repart", // наименование продавца
"descr_rating_count": "5 отзывов", // сколько отзывов
"rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_address": "Москва, м. Полежаевская", // местоположение
"phone1": "8(926)103-45-33", // телефон 1
"phone2": "8(926)103-45-34", // телефон 2
"comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
"commentV2": "Возможна доставка оптовым покупателям", // краткая информация о продавце (существующее поле comment содержит сочетание двух полей - времени работы компании и краткой информации о продавце)
"info": "Публикуется в ZZap с 20-08-12", // когда началось сотрудничество с ZZap
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"accept_messages": true, // хочет ли продавец принимать сообщения
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней" // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"work_time: "пн.-пт. с 10 до 20, сб. с 10 до 18, вс. выходной", // время работы продавца
"type_user": "UBNAIRWPYTOGM234", // тип пользователя
"type_user2": "GCKMN", // тип пользователя 2
"type_price": "RMP", // тип прайс-листа
"telegram": "89261234567", // номер в telegram
"whatsapp": "89261234567", // номер в whatsapp
"viber": "89261234567", // номер в viber
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"seller_addressV2": "Россия, Москва, Хорошевское шоссе 39", // полный адрес продавца
"seller_location": "Москва, м. Полежаевская" // город и метро продавца
"descr_rating_year_count": "15 отзывов", // сколько отзывов за год
"rating_year": 3, // рейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_rating_total_count": "40 отзывов", // сколько отзывов за всё время
"rating_total": 3, // рейтинг за всё время: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
}
Метод "информация о позиции" (GetSearchResultInfoV3)
GetSearchResultInfoV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | нет | e-mail, указанный при регистрации на сайте ZZap (может быть пустым) |
password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
partnumber | string | да | номер запчасти |
class_man | string | да | производитель запчасти |
code_cur | string | да | валюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге |
code_region | string | да | code_region из метода GetRegions |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер |
class_cat | string | да | наименование |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_cat | int | да | внутренний уникальный код позиции |
class_cur | string | да | валюта (например, белорусские рубли) |
price_count_instock | int | да | количество предложений в наличии |
price_min_instock | decimal | да | минимальная цена среди предложений в наличии |
price_avg_instock | decimal | да | средняя цена среди предложений в наличии |
price_max_instock | decimal | да | максимальная цена среди предложений в наличии |
price_count_order | int | да | количество предложений под заказ |
price_min_order | decimal | да | минимальная цена среди предложений под заказ |
price_avg_order | decimal | да | средняя цена среди предложений под заказ |
price_max_order | decimal | да | максимальная цена среди предложений под заказ |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI&code_cur=5&code_region=1&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "partnumber=MR245368" --data-urlencode "code_cur=5" --data-urlencode "code_region=1" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3
Ответ
{
"error": "", // если пусто, ошибок нет
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "НАСОС ВОДЯНОЙ", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1114507085 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
}
В приведённом примере цены в белорусских рублях
Для российских рублей действует округление цен до целого значения.
Метод "моя история поиска" (GetMySearchHistoryV2)
GetMySearchHistoryV2
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
api_key | string | да | нужно попросить у нас |
call_data | string | да | для внутренних целей, передавать пустое значение |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
table | Массив GetMySearchHistoryItem[] | да | Массив данных |
GetMySearchHistoryItem:
Параметр | Тип | Обязательный | Описание |
create_date | DateTime | да | дата поиска запчасти (информативна только дата, учитываем не повторяющиеся позиции за день, время всегда 00:00:00) |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер |
class_cat | string | да | наименование запчасти |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
code_cat | int | да | внутренний код позиции |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2?login={login}&password={password}&api_key={api_key}&call_data=
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "api_key={api_key}" --data-urlencode "call_data=" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2
Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00)
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "Помпа", // наименование запчасти
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"], // массив ссылок на превью фото запчасти 60px на 60px
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"code_cat": 353454213 // внутренний код позиции
}
{
...
}
]
}
Метод "результат поиска" (GetSearchResultLight)
Аналогично GetSearchResultV3, но только по запрошенному номеру (без замен)
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultLight
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
code_region | string | да | code_region из метода GetRegions |
search_text | string | да | произвольная строка поиска |
partnumber | string | да | номер запчасти |
class_man | string | да | производитель запчасти |
row_count | string | да | ограничение по кол-ву строк. по умолчанию 100, максимум 500 |
type_request | string | да | 4 - любые только по запрошенному номеру, 5 - только новые и только по запрошенному номеру |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
terms | strings | да | "колодок;колодку;колодкою; колодкой; колодке;колодках;колодками; колодкам; колодка;колодки;колодки" поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений. |
class_man | string | да | производитель запрашиваемой запчасти |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px запрашиваемой запчасти |
partnumber | string | да | номер запрашиваемой запчасти |
class_cat | string | да | наименование запрашиваемой запчасти |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** запрашиваемой запчасти |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** запрашиваемой запчасти |
code_cat | int | да | внутренний уникальный код позиции запрашиваемой запчасти |
class_cur | string | да | валюта (например, белорусские рубли) запрашиваемой запчасти |
price_count_instock | int | да | количество предложений в наличии запрашиваемой запчасти |
price_min_instock | decimal | да | минимальная цена среди предложений в наличии запрашиваемой запчасти |
price_avg_instock | decimal | да | средняя цена среди предложений в наличии запрашиваемой запчасти |
price_max_instock | decimal | да | максимальная цена среди предложений в наличии запрашиваемой запчасти |
price_count_order | int | да | количество предложений под заказ запрашиваемой запчасти |
price_min_order | decimal | да | минимальная цена среди предложений под заказ запрашиваемой запчасти |
price_avg_order | decimal | да | средняя цена среди предложений под заказ запрашиваемой запчасти |
price_max_order | decimal | да | максимальная цена среди предложений под заказ запрашиваемой запчасти |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) запрашиваемой запчасти |
table | Массив GetSearchResultItem[] | да | Массив данных |
GetSearchResultItem:
Параметр | Тип | Обязательный | Описание |
code_doc_b | long | да | внутренний уникальный код предложения (нужно передавать в GetSearchResultOne) |
code_cat | int | да | внутренний уникальный код позиции |
descr_type_search | string | да | тип предложения |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер |
class_cat | string | да | наименование |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
qty | string | да | кол-во, текст! |
apply | string | да | условия продажи, если указаны продавцом |
min_sum_order | decimal | да | минимальная сумма заказа, если указана продавцом |
descr_min_sum_order | string | да | минимальная сумма заказа текстом, если указана продавцом |
shipment | string | да | условия доставки |
courier | bool | да | доставка курьером: если true - есть, если false - нет |
instockV2 | bool | да | наличие на складе |
wholesaleV2 | bool | да | тип цены (для юр. лиц и ИП, если true, или для розницы, если false) |
localV2 | bool | да | если true, то предложение локальное, если false, то из другого региона |
priceV2 | decimal | да | цена (в той валюте, в которой смотрел покупатель) |
price_date | DateTime | да | дата публикации |
descr_priceV2 | string | да | цена текстом с коротким обозначением валюты, в которой смотрел покупатель |
price_orig | decimal | да | цена (в той валюте, в которой публиковал продавец) |
descr_price_orig | string | да | цена текстом (в той валюте, в которой публиковал продавец) |
descr_type_price | string | да | отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто) |
descr_qty | string | да | подпись под кол-вом |
class_user | string | да | наименование продавца |
descr_rating_count | string | да | сколько отзывов текстом |
rating | int | да | рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд |
descr_address | string | да | местоположение |
phone1 | string | да | телефон |
order_text | string | да | три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) |
user_key | string | да | "ключ" продавца, с помощью которого вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) |
addr_map_geo1 | double | да | широта (координаты местонахождения продавца) |
addr_map_geo2 | double | да | долгота (координаты местонахождения продавца) |
type_search | int | да | 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценка, |
usedV2 | bool | да | тип предложения: false – обычное предложение, true – б/у и уценка |
qtyV2 | int | да | количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») |
qty_max | int | да | максимально допустимое количество для заказа по конкретному предложению продавца |
descr_qtyV2 | string | да | количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» |
delivery_days | int | да | количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) |
descr_delivery | string | да | срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») |
type_user | string | да | тип пользователя* |
type_user2 | string | да | тип пользователя 2** |
type_price | string | да | тип прайс-листа*** |
descr_price_date | string | да | давности обновления прайс-листа |
pack | int | да | кратность (упаковка) числом |
descr_pack | string | да | кратность (упаковка) текстом |
type_chain_search | int | да | основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений |
noorig | bool | да | если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
location | string | да | город и метро продавца |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultLight?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&code_region=11135&row_count=100&type_request=4&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=Колодки Nissan" --data-urlencode "partnumber=MR245368" --data-urlencode "class_man=MITSUBISHI" --data-urlencode "code_region=11135" --data-urlencode "row_count=100" --data-urlencode "type_request=4" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultLight
Ответ
{
"error":"", // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"class_man": "MITSUBISHI", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"table": [ {
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"code_cat": 1116901944 // внутренний уникальный код позиции
"descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе
"wholesaleV2": true, // тип цены (для юр. лиц и ИП, если true, или для розницы, если false)
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"class_user": "Repart", // наименование продавца
"descr_rating_count": "5 отзывов", // сколько отзывов
"rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_address": "Москва, м. Юго-Западная", // местоположение
"phone1": "8(926)103-45-33", // телефон
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"type_search": 10, // 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценке
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней", // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"type_user": "UBNAIRWPYTOGM234", // тип пользователя
"type_user2": "GCKMNZ", // тип пользователя 2
"type_price": "RMP", // тип прайс-листа
"descr_price_date":"Сегодня 13ч. назад" // текстовое описание давности обновления прайс-листа
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"location": ""Москва, м. Юго-Западная" // город и метро продавца
}
{
...
}
]
}
Важно!
Для данного метода значения входного параметра type_request могут быть только 4 и 5
Метод "каталог шин" (GetCatalogTyres)
GetCatalogTyres
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_r='R20' |
sort | string | да | сортировка по колонкам, например class_cat asc(asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_r_enum | string[] | да | массив из возможных значений поля tag_r - радиус, использовать для фильтра. |
tag_m_enum | string[] | да | массив из возможных значений поля tag_m - ширина, использовать для фильтра. |
tag_n_enum | string[] | да | массив из возможных значений поля tag_n - высота, использовать для фильтра. |
tag_l_enum | string[] | да | массив из возможных значений поля tag_l - сезон, использовать для фильтра. |
table | Массив GetCatalogTyresItem[] | да | массив данных |
GetCatalogTyresItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
comment | string | да | описание позиции |
price_min | decimal | да | минимальная цена |
price_med | decimal | да | цена медиана |
price_max | decimal | да | максимальная цена |
price_count | int | да | кол-во предложений |
tag_r | string | да | радиус |
tag_m | string | да | ширина |
tag_n | string | да | высота |
tag_q | string | да | индекс скорости |
tag_l | string | да | сезон |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres?login={login}&password={password}&filter=&sort=&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "filter=" --data-urlencode "code_region=1" --data-urlencode "row_count=3" --data-urlencode "row_start=" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres
Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 3, // сколько строк вернулось
"row_count_total":18975,
"class_man_enum":["ACHILLES","ALTENZO","AMTEL"....],
"tag_r_enum":["R12","R13","R14","R15","R16","R17","R17.5","R18","R19","R20","R21","R22","R22.5","R23","R24"],
"tag_m_enum":["27\"","30\"","31\"","32\"","33\"","35\"","37\"","38\"","39\"","40\"","135","145","155","165","175", "185","195","205","215","225","235","245","255","265","275","285","295","305","315","325", "335","345","355","385"],
"tag_n_enum":["8.5\"","9.5\"","10.5\"","11.5\"","12.5\"","13.5\"","14.5\"","20","25","30","35","40","45","50","55", "60","65","70","75","80","85","90"],
"tag_l_enum": ["Всесезонная","Зимняя нешипованная","Зимняя шипованная","Летняя"]
"table":
[
{
"class_man":"MICHELIN",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s7ade3bde2d5ac9cb8138285159d321f9.jpg",
"partnumber":"ZZ436707390",
"class_cat":"X-ICE",
"code_cat":1749664696,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p28b88ff9dff8732e44dd3d8bf957b2ad.jpg"],
"code_man":3186,
"comment":"Зимняя нешипуемая шина Michelin X-Ice с направленным рисунком ....",
"price_min":7978.20,
"price_med":8796.50,
"price_max":10996.50,
"price_count":35,
"tag_r":"R16",
"tag_m":"205",
"tag_n":"55",
"tag_q":"T94 XL",
"tag_l":"Зимняя нешипованная"}
...
]
}
Метод "каталог аккумуляторов" (GetCatalogBatteries)
GetCatalogBatteries
https://api.zzap.pro/webservice/datasharing.asmx?op=GetCatalogBatteries
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_h='7.5А*ч' |
sort | string | да | сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_x_enum | string[] | да | массив из возможных значений поля tag_x - длина использовать для фильтра. |
tag_y_enum | string[] | да | массив из возможных значений поля tag_y - ширина, использовать для фильтра. |
tag_z_enum | string[] | да | массив из возможных значений поля tag_z - высота, использовать для фильтра. |
tag_h_enum | string[] | да | массив из возможных значений поля tag_h - ёмкость, использовать для фильтра. |
tag_1_enum | string[] | да | массив из возможных значений поля tag_1 - полярность, использовать для фильтра. |
tag_f_enum | string[] | да | массив из возможных значений поля tag_f - ток холодной прокрутки, использовать для фильтра. |
table | Массив GetCatalogBatteriesItem[] | да | массив данных |
GetCatalogBatteriesItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
comment | string | да | описание позиции |
price_min | decimal | да | минимальная цена |
price_med | decimal | да | цена медиана |
price_max | decimal | да | максимальная цена |
price_count | int | да | кол-во предложений |
tag_x | string | да | длина |
tag_y | string | да | ширина |
tag_z | string | да | высота |
tag_h | string | да | ёмкость |
tag_1 | string | да | полярность |
tag_f | string | да | ток холодной прокрутки |
tag_u | string | да | напряжение |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogBatteries?login={login}&password={password}&filter=tag_1='обратная' and tag_f='SAE: 900' and tag_h='80А*ч'&sort=class_cat asc&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «filter=tag_1='обратная' and tag_f='SAE: 900' and tag_h='80А*ч'» —data-urlencode «sort=class_cat asc» —data-urlencode «code_region=1» —data-urlencode «row_count=3» —data-urlencode «row_start=» —data-urlencode «api_key={api_key}» -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogBatteries
Ответ
{
«error»: «» // если пусто, ошибок нет
«row_count»: 3, // сколько строк вернулось
«row_count_total»:3018,
"class_man_enum":["ACDELCO","AFA","AKOM","AKTEX","ALASKA","ALKOR","ALPHALINE","AMERICAN","ASP MENSAN","ATLAS","AUTO DELTA","AUTOPART","BAREN","BERGA","BMW","BOLK","BOSCH","CENTRA","CHRYSLER", "COUGAR","DEKA","DELKOR","DELTA BATTERY","DETA","EDCON","ENERGIZER","ENEUS", ...],
"tag_f_enum":["","SAE: 0","SAE: 0.36","SAE: 10","SAE: 20","SAE: 30","SAE: 35","SAE: 40","SAE: 44","SAE: 45","SAE: 50","SAE: 55","SAE: 60","SAE: 65","SAE: 70","SAE: 74","SAE: 75","SAE: 80","SAE: 85","SAE: 90","SAE: 95","SAE: 100","SAE: 105","SAE: 110", ...],
"tag_h_enum":["","А*ч","0.33А*ч","0.44А*ч","1.2А*ч","2.2А*ч","2.3А*ч","2.5А*ч","3А*ч","3.2А*ч","3.5А*ч", "4А*ч","4.2А*ч","5А*ч","5.5А*ч","6А*ч","6.3А*ч","6.5А*ч","6.8А*ч","7А*ч","7.5А*ч","8А*ч", "8.4А*ч","8.6А*ч","9А*ч","9.5А*ч","10А*ч","11А*ч", ...],
"tag_x_enum":[""," мм","85 мм","91 мм","95 мм","97 мм","98 мм","100 мм","103 мм","113 мм","114 мм","115 мм","119 мм","120 мм","121 мм","122 мм","130 мм","132 мм","133 мм","134 мм","135 мм","136 мм","137 мм", ...],
"tag_y_enum":[""," мм","100 мм","101 мм","124 мм","125 мм","126 мм","127 мм","128 мм","129 мм","130 мм","131 мм","132 мм","133 мм","134 мм","135 мм","136 мм","137 мм","140 мм","165 мм","167 мм", ...],
"tag_z_enum":[""," мм","100 мм","104 мм","105 мм","106 мм","107 мм","108 мм","110 мм","112 мм","114 мм","115 мм","116 мм","129 мм","130 мм","131 мм","132 мм","133 мм","134 мм","135 мм","136 мм","139 мм","140 мм","143 мм","145 мм","146 мм","147 мм", ...],
"tag_1_enum":["","обратная","прямая","универсальная","центрированная"]
"table":
[
{
"class_man":"BMW",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/se12d7724469c1dbbe07e303ac6e91b48.png",
"partnumber":"61216924023",
"class_cat":"ОРИГИНАЛЬНАЯ АКК.БАТАРЕЯ BMW AGM",
"code_cat":115841361,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p3b3ef71a3371bc74878b7ed831130c62.jpg"],
"code_man":3074,
"comment":"",
"price_min":23500.00,
"price_med":48422.17,
"price_max":98201.00,
"price_count":59,
"tag_f":"SAE: 900",
"tag_h":"80А*ч",
"tag_u":"12V",
"tag_x":"353 мм",
"tag_y":"175 мм",
"tag_z":"190 мм",
"tag_1":"обратная"}
]
}
Метод "каталог масел" (GetCatalogOils)
GetCatalogOils
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogOils
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_v='0W-40' |
sort | string | да | сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_v_enum | string[] | да | массив из возможных значений поля tag_v - вязкость, использовать для фильтра. |
tag_w_enum | string[] | да | массив из возможных значений поля tag_w - объём, использовать для фильтра. |
tag_s_enum | string[] | да | массив из возможных значений поля tag_s - тип масла, использовать для фильтра. |
table | Массив GetCatalogOilsItem[] | да | массив данных |
GetCatalogOilsItem:
Параметр
Тип
Обязательный
Описание
class_man
string
да
производитель
logopath
string
да
ссылка на превью логотипа производителя 30px на 30px
partnumber
string
да
номер производителя
class_cat
string
да
наименование
code_cat
int
да
внутренний уникальный код позиции
imagepath
string[]
да
массив ссылок на превью фото запчасти 60px на 60px****
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
comment
string
да
описание позиции
price_min
decimal
да
минимальная цена
price_med
decimal
да
цена медиана
price_max
decimal
да
максимальная цена
price_count
int
да
кол-во предложений
tag_v
string
да
вязкость
tag_w
string
да
объём
tag_s
string
да
тип масла
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogOils?login={login}&password={password}&filter=tag_s = 'минеральное' and tag_w='1 л'&sort=&row_count=3&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «filter=tag_s = 'минеральное' and tag_w='1 л'» —data-urlencode «sort=» —data-urlencode «code_region=1» —data-urlencode «row_count=3» —data-urlencode «row_start=» —data-urlencode «api_key={api_key}» -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogOils
Ответ
{
"error":"",
"row_count":3,
"row_count_total":17127,
"class_man_enum":["3TON","76","ABKO","ABRO","ACDELCO","ADDINOL","AGIP","AIMOL","AISIN","ALPINE", "AMALIE","AMSOIL","ARAL","ARCTIC CAT","ARDECA", ...],
"tag_v_enum":["","2W","2.5W","4W","5W","0W-7.5","7.5W","7.5W-40","0W-10","10W","15W","0W-16","0W-20","20W","0W-30","30W","0W-40","40W","0W-50","50W","60W","75W","80W","90W","5W-16","5W-20","5W-30","5W-40", ...],
"tag_w_enum":["0.03 л","0.04 л","0.1 л","0.13 л","0.15 л","0.178 л","0.2 л","0.24 л","0.25 л","0.3 л","0.35 л","0.355 л","0.4 л","0.473 л","0.48 л","0.5 л","0.6 л","0.75 л","0.8 л","0.85 л","0.9 л","0.94 л","0.946 л","0.95 л","1 л","1.4 л", ...],
"tag_s_enum":["Минеральное","Полусинтетическое","Синтетическое"],
"table":
[
{
"class_man":"VAG",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s4f9b7cd5f147fda0e382c6638a11c846.gif",
"partnumber":"G004000M2",
"class_cat":"Жидкость гидроусилителя руля (зеленая)",
"code_cat":114838544,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p743fa6cb7e71789f27c424bd054a996b.jpg"],
"code_man":3261,
"comment":"",
"price_min":1157.76,
"price_med":2175.58,
"price_max":5364.00,
"price_count":1707,
"tag_v":"",
"tag_w":"1 л",
"tag_s":"Минеральное"
},
{
...
}
]
}
Метод "каталог дисков" (GetCatalogDisks)
GetCatalogDisks
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogDisks
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_e='-44' |
sort | string | да | сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_i_enum | string[] | да | массив из возможных значений поля tag_i - ширина обода, использовать для фильтра. |
tag_r_enum | string[] | да | массив из возможных значений поля tag_m - диаметр, использовать для фильтра. |
tag_e_enum | string[] | да | массив из возможных значений поля tag_e - вылет, использовать для фильтра. |
tag_b_enum | string[] | да | массив из возможных значений поля tag_b - количество отверстий, использовать для фильтра. |
tag_p_enum | string[] | да | массив из возможных значений поля tag_p - диаметр расположения отверстий, использовать для фильтра. |
tag_j_enum | string[] | да | массив из возможных значений поля tag_j - тип, использовать для фильтра. |
table | Массив GetCatalogDisksItem[] | да | массив данных |
GetCatalogDisksItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
comment | string | да | описание позиции |
price_min | decimal | да | минимальная цена |
price_med | decimal | да | цена медиана |
price_max | decimal | да | максимальная цена |
price_count | int | да | кол-во предложений |
tag_i | string | да | ширина обода |
tag_r | string | да | диаметр |
tag_e | string | да | вылет |
tag_b | string | да | количество отверстий |
tag_p | string | да | диаметр расположения отверстий |
tag_j | string | да | тип |
tag_d | string | да | диаметр ступицы |
tag_c | string | да | цвет |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogDisks?login={login}&password={password}&filter=&sort=&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «filter=» —data-urlencode «sort=» —data-urlencode «code_region=1» —data-urlencode «row_count=3» —data-urlencode «row_start=» —data-urlencode «api_key={api_key}» -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogDisks
Ответ
{
"error":"",
"row_count":3,
"row_count_total":6863,
"class_man_enum":["1000 MIGLIA","4GO","AERO","AEZ","ALCASTA","ALUTEC","ARRIVO","ASW","ATS","BORBET", "BUFFALO","CROSSSTREET","DEZENT","DOTZ","ENKEI","EURODISK","FONDMETAL","GOLD WHEEL","HARP","IFREE","IKON WHEELS","INFORGED","KRONPRINZ","LEGEARTIS","LS FLOWFORMING","LS WHEELS","MAK","MANDRUS","MEFRO","MEGAMI","MOMO","MSW","NEXT","NITRO","NZ", "OFF ROAD WHEELS","OZ","PDW","RACE READY","RACING WHEELS","RAPID","REPLAY","REPLICA","REPLIKEY","RIAL","SDT","SPARCO","STEGER","TECH LINE","TREBL","VISSOL","VOSSEN","X TRIKE","YAMATO","YOKATTA","YST","ВАЗ","ГАЗ","КИК","КРКЗ","СКАД","ТЗСК"],
"tag_r_enum":["R13","R14","R15","R16","R17","R18","R19","R20","R21","R22"],
"tag_i_enum":["4.5","5.0","5.5","6.0","6.5","7.0","7.5","8.0","8.5","9.0","9.5","10.0","10.5","11.0","11.5"],
"tag_e_enum":["0","2","5","-5","6","8","10","-10","12","-12","13","14","15","-15","16","-16","17","18","19","-19", "20","-20","21","22","-22","23","24","-24","25","-25","26","27","28","29","30","-30","31","31.5", "32","33","34","35","-35","36","36.5","37","37.5","38","38.5","39","39.5","40","-40","41","42", "42.5","43","44","-44","45","46","47","47.5","48","48.5","49","49.5","50","50.8","51","52","52.5", "53","54","55","56","56.4","57","58","59","60","62","64","65","66","68","75","102","105","106"],
"tag_p_enum":["100","105","108","110","112","114.3","115","118","120","127","130","139.7","150","160","165","165.1","170","98"],
"tag_b_enum":["3","4","5","6"],
"tag_j_enum":["кованый","литой","штампованный"],
"table":
[
{
"class_man":"ГАЗ",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/se12d7724469c1dbbe07e303ac6e91b48.png",
"partnumber":"Z1794725854",
"class_cat":"Волга 31105 ",
"code_cat":1764433334,
"imagepath":[""],
"code_man":690,
"comment":"",
"price_min":3450.00,
"price_med":3450.0,
"price_max":3450.00,
"price_count":1,
"tag_r":"R15",
"tag_i":"6.5",
"tag_e":"45",
"tag_d":"58",
"tag_b":"5",
"tag_p":"108",
"tag_j":"штампованный",
"tag_c":"Серебристый"
},
{
...
}
]
}
Метод "каталог грузовых шин" (GetCatalogTrucktyres)
GetCatalogTrucktyres
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTrucktyres
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_r='R20' |
sort | string | да | сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_r_enum | string[] | да | массив из возможных значений поля tag_r - диаметр, использовать для фильтра. |
tag_8_enum | string[] | да | массив из возможных значений поля tag_8 - ширина, использовать для фильтра. |
tag_9_enum | string[] | да | массив из возможных значений поля tag_9 - высота, использовать для фильтра. |
tag_4_enum | string[] | да | массив из возможных значений поля tag_4 - камера, использовать для фильтра. |
tag_5_enum | string[] | да | массив из возможных значений поля tag_5 - ось, использовать для фильтра. |
table | Массив GetCatalogTrucktyresItem[] | да | массив данных |
GetCatalogTrucktyresItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
comment | string | да | описание позиции |
price_min | decimal | да | минимальная цена |
price_med | decimal | да | цена медиана |
price_max | decimal | да | максимальная цена |
price_count | int | да | кол-во предложений |
tag_r | string | да | диаметр |
tag_8 | string | да | ширина |
tag_9 | string | да | высота |
tag_q | string | да | индекс скорости |
tag_4 | string | да | камера |
tag_5 | string | да | ось |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTrucktyres?login={login}&password={password}&filter=&sort=&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «filter=» —data-urlencode «sort=» —data-urlencode «code_region=1» —data-urlencode «row_count=3» —data-urlencode «row_start=» —data-urlencode «api_key={api_key}» -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTrucktyres
Ответ
{
"error":"",
"row_count":3,
"row_count_total":421,
"class_man_enum":["BARUM","BF GOODRICH","BRIDGESTONE","CONTINENTAL","CORDIANT","DOUBLESTAR","FIRESTONE", "FULDA","GOODTRIP","GOODYEAR","GT RADIAL","HANKOOK","HIFLY","KAMA", ...],
"tag_r_enum":["R17.5","R19.5","R20","R21","R22.5","R24","R22,5","R533"],
"tag_8_enum":["205","215","225","235","245","255","265","275","285","295","315","325","365","385", "400", "425","435","445","500","1220"],
"tag_9_enum":["45","50","55","60","65","70","75","80","85","95","400"],
"tag_4_enum":["TL","TT","ведущая"],
"tag_5_enum":["ведущая","прицеп","рулевая","универсальная"],
"table":
[
{
"class_man":"OVATION",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s5526c2bd6f00f85a0599221ff0c6e9cd.jpg",
"partnumber":"Z2126167167",
"class_cat":"VI-022 ",
"code_cat":1765221314,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p4b31e55540a115b22137453263b1f092.jpg"],
"code_man":12018,
"comment":"Всесозонная шина",
"price_min":24960.00,
"price_med":24960.0,
"price_max":24960.00,
"price_count":1,
"tag_r":"R22.5",
"tag_8":"385",
"tag_9":"65",
"tag_q":"K160/156",
"tag_4":"TL",
"tag_5":"прицеп"
},
{
...
}
]
}
Метод "каталог мотошин" (GetCatalogMototyres)
GetCatalogMototyres
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogMototyres
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации (может быть пустым) |
password | string | да | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
filter | string | да | произвольная строка фильтрации, например tag_r='R19' |
sort | string | да | сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля) |
code_region | string | да | code_region из метода GetRegions |
row_count | string | да | сколько максимально записей возвращать |
row_start | string | да | с каким сдвигом от нулевой строки возвращать записи |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса. |
row_count | int | да | сколько строк вернулось |
row_count_total | int | да | сколько всего строк в таблице без учета фильтрации |
class_man_enum | string[] | да | массив из возможных значений поля class_man - производителей, использовать для фильтра. |
tag_r_enum | string[] | да | массив из возможных значений поля tag_r - диаметр, использовать для фильтра. |
tag_6_enum | string[] | да | массив из возможных значений поля tag_8 - ширина, использовать для фильтра. |
tag_7_enum | string[] | да | массив из возможных значений поля tag_9 - высота, использовать для фильтра. |
table | Массив GetCatalogMototyres[] | да | массив данных |
GetCatalogMototyresItem:
Параметр | Тип | Обязательный | Описание |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
partnumber | string | да | номер производителя |
class_cat | string | да | наименование |
code_cat | int | да | внутренний уникальный код позиции |
imagepath | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
comment | string | да | описание позиции |
price_min | decimal | да | минимальная цена |
price_med | decimal | да | цена медиана |
price_max | decimal | да | максимальная цена |
price_count | int | да | кол-во предложений |
tag_r | string | да | диаметр |
tag_6 | string | да | ширина |
tag_7 | string | да | высота |
tag_q | string | да | индекс скорости |
Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogMototyres?login={login}&password={password}&filter=&sort=&code_region=1&row_count=3&row_start=&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «filter=» —data-urlencode «sort=» —data-urlencode «code_region=1» —data-urlencode «row_count=3» —data-urlencode «row_start=» —data-urlencode «api_key={api_key}» -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogMototyres
Ответ
{
"error":"",
"row_count":3,
"row_count_total":482,
"class_man_enum":["BRIDGESTONE","CONTINENTAL","DUNLOP","HEIDENAU","KENDA","METZELER", "MICHELIN","MITAS","PIRELLI"],
"tag_r_enum":["R6","R10","R11","R12","R13","R14","R15","R16","R16.5","R17","R18","R19","R21"],
"tag_6_enum":["60","70","80","90","100","110","120","125","130","140","145","150","160","170","180","190", "200","210","240","260","280","300"],
"tag_7_enum":["35","40","50","55","60","65","70","75","80","90","100"],
"table":
[
{
"class_man":"MICHELIN",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s7ade3bde2d5ac9cb8138285159d321f9.jpg",
"partnumber":"ZZ169619529",
"class_cat":"Pilot Road 4 GT",
"code_cat":1764425163,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p261f3b7fadc53c30b7049f31c2d5ff19.jpg"],
"code_man":3186,
"comment":"",
"price_min":20583.87,
"price_med":20742.32,
"price_max":21199.44,
"price_count":3,
"tag_r":"R17",
"tag_6":"180",
"tag_7":"55",
"tag_q":"W73"
},
{
...
}
]
}
*type_user
'K' - медаль "Официальный автодилер"
'1' - медаль "Больше года на сайте"
'2' - медаль "Больше 3х лет на сайте"
'3' - медаль "Есть уставные документы"
'4' - медаль "Есть фотографии магазина"
'5' - международная отправка
'P' - Доставка товара курьером
'Y' - Отправка товара в регионы
'B' - Покупатель
'A' - Продавец
'I' - Интернет магазин
'S' - Автосервис/служба установки
'R' - Торговля в розницу
'W' - Торговля оптом
'F' - Частное лицо
'U' - Юридическое лицо
**type_user2
'Y' - Понизить до недостоверных
'K' - Принимаем к оплате банковские карты
'M' - Ручная проверка (снимает пометку Регистрация не подтверждена)
'I' - Неликвидный товар (клиент продаёт неликвид)
'W' - Шиномонтаж
'R' - Не хотят переписываться с покупателями
'Z' - Подтверждена гарантия наличия
'F' - Подтверждение наличия
'R' - Не переписываются с покупателями
***type_price
'R' - Прайс-лист для розницы
'W' - Прайс-лист для юр.лиц и ИП
'M' - Запретить загрузку прайса с сайта как файл
'I' - Неликвидный товар
'P' - Есть самовывоз
****imagepath
ссылка https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg содержит в имени файла "p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" букву p, что делает картинку превью 60px на 60px. если из ссылки эту букву убрать, получится ссылка на картинку оригинального размера (изначально загруженная картинка) https://koj.blob.core.windows.net/zzap-upload/upload/catalog/2739725d8d53bff0ccf0ecbfb9cf920b.jpg