Поиск

Главная > Помощь > Поиск

Метод "подсказка" (GetSearchSuggestV3)

Аналогично GetSearchSuggest, но с дополнительным параметром type_request, login и password
GetSearchSuggestV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
search_textstringдапроизвольная строка поиска
row_countstringдасколько максимально записей возвращать
type_requeststringдатип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам)
api_keystringданужно попросить у нас

Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
row_countintдасколько строк вернулось
termsstringдаполе terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
tableМассив GetSearchSuggestItem[]дамассив данных

GetSearchSuggestItem:

ПараметрТипОбязательныйОписание
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер производителя
class_catstringданаименование
code_catintдавнутренний уникальный код позиции
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе 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 да нужно попросить у нас

Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
row_countintдасколько строк вернулось
termsstringsда"колодок;колодку;колодкою;
колодкой;
колодке;колодках;колодками;
колодкам;
колодка;колодки;колодки"
поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
class_manstringдапроизводитель запрашиваемой запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px запрашиваемой запчасти
partnumberstringданомер запрашиваемой запчасти
class_catstringданаименование запрашиваемой запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
code_catintдавнутренний уникальный код позиции запрашиваемой запчасти
class_curstringдавалюта (например, белорусские рубли) запрашиваемой запчасти
price_count_instockintдаколичество предложений в наличии запрашиваемой запчасти
price_min_instockdecimalдаминимальная цена среди предложений в наличии запрашиваемой запчасти
price_avg_instockdecimalдасредняя цена среди предложений в наличии запрашиваемой запчасти
price_max_instockdecimalдамаксимальная цена среди предложений в наличии запрашиваемой запчасти
price_count_orderintдаколичество предложений под заказ запрашиваемой запчасти
price_min_orderdecimalдаминимальная цена среди предложений под заказ запрашиваемой запчасти
price_avg_orderdecimalдасредняя цена среди предложений под заказ запрашиваемой запчасти
price_max_orderdecimalдамаксимальная цена среди предложений под заказ запрашиваемой запчасти
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) запрашиваемой запчасти
tableМассив GetSearchResultItem[]даМассив данных

GetSearchResultItem:

ПараметрТипОбязательныйОписание
code_doc_blongдавнутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
code_catintдавнутренний уникальный код позиции
descr_type_searchstringдатип предложения
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qtystringдакол-во, текст!
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставки
courierboolдадоставка курьером: если true - есть, если false - нет
instockV2boolданаличие на складе
wholesaleV2boolдатип цены (для юр. лиц и ИП, если true, или для розницы, если false)
localV2boolдаесли true, то предложение локальное, если false, то из другого региона
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
price_dateDateTimeдадата публикации
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон
order_textstringдатри варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
user_keystringда"ключ" продавца, с помощью которого вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
type_searchintда10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценка,
    
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
descr_price_datestringдадавности обновления прайс-листа
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
type_chain_searchintдаосновные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorigboolдаесли true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
locationstringдагород и метро продавца
descr_rating_year_countstringдасколько отзывов за год (текстом)
rating_yearintдарейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_rating_total_countstringдасколько отзывов за всё время (текстом)
rating_totalintдарейтинг за всё время: если 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 да нужно попросить у нас

Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
code_doc_blongдавнутренний уникальный код предложения
code_catintдавнутренний уникальный код код позиции
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qtystringдакол-во, текст!
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставк
courierboolдадоставка курьером: если true - есть, если false - нет
instockV2boolданаличие на складе
wholesaleV2boolдатип цены (для юр. лиц и ИП, если true, или для розницы, если false)
localV2boolдаесли true, то предложение локальное, если false, то из другого региона
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
priceV3decimalдацена в рублях
price_dateDateTimeдадата публикации
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
descr_priceV3stringдацена в рублях
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
commentV2stringдакраткая информация о продавце
infostringдакогда началось сотрудничество с ZZap
order_textstringдатри варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
accept_messagesboolдаготов ли продавец переписываться с покупателями: true - готов, false - не готов
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
work_timestringдавремя работы продавца
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
telegramstringданомер в telegram
whatsappstringданомер в whatsapp
viberstringданомер в viber
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
type_chain_searchintдаосновные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorigboolдаесли true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
seller_addressV2stringдаполный адрес продавца
seller_locationstringдагород и метро продавца
descr_rating_year_countstringдасколько отзывов за год (текстом)
rating_yearintдарейтинг за год: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_rating_total_countstringдасколько отзывов за всё время (текстом)
rating_totalintдарейтинг за всё время: если 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

Поиск