API zzap.ru

Базовая ссылка вебсервиса 

https://api.zzap.pro/webservice/datasharing.asmx

ВЕБ ХУКИ

Для продавцов есть возможность настроить получение данных о заказах покупателей на свой сайт

Отправка заказа от покупателя на сайт продавца (вэб-хуки)

Получить api_key 

Для того, чтобы воспользоваться ниже описанными методами выгрузки данных, необходимо получить api_key

• Если вы покупатель, напишите нам на почту или создайте заявку в разделе "Заявки на тех.поддержку", и вам пришлют api_key
• Если вы продавец и знаете, кто ваш менеджер, обратитесь к нему - менеджер вышлет вам api_key
• Если вы продавец, но по каким-то причинам не знаете, кто ваш менеджер, или на данный момент к вам не прикреплён ни один из наших менеджеров, поступайте, как покупатель

Правила работы 

• API создан для интеграции с продавцами запчастей
• недопустимо использовать API для выкачивания актуальных предложений или мониторинга через выкачивание
• мы имеет право отозвать API ключ в любой момент без объяснения причин
• частота запросов по API должна быть не выше 1 запроса в 3 секунды
  (1 запрос в 6-50 секунд, для методов которые начинаются с GetSearchSuggest* и GetSearchResult*, исключая GetSearchResultLight^{рекомендуем} , так же возможно появление каптчи в случае длительного превышения частоты запросов)
• при использовании данных нашего сайта необходимо указывать в верхней части страницы (или у кнопки "Поиск") заметное упоминание о том, что данные предоставлены сайтом ZZap, а также размещать ссылку с переходом на ZZap
  (пример надписи: "Информация о запчастях предоставлена системой ZZap")
• запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию. Обычно требуется несколько секунд, чтобы изменение проявилось всюду

Важно 

• все даты выдаются по московскому времени!

Методы 

• Поиск
  - Метод "подсказка" (GetSearchSuggestV3)
  - Метод "результат поиска" (GetSearchResultV3)
  - Метод "одно предложение" (GetSearchResultOneV2)
  - Метод "информация о позиции" (GetSearchResultInfoV3)
  - Метод "моя история поиска" (GetMySearchHistoryV2)
  - Метод "результат поиска лайт" (GetSearchResultLight)^{рекомендуем}
  - Метод "каталог шин" (GetCatalogTyres)
  - Метод "каталог аккумуляторов" (GetCatalogBatteries)
  - Метод "каталог масел" (GetCatalogOils)
  - Метод "каталог дисков" (GetCatalogDisks)
  - Метод "каталог грузовых шин" (GetCatalogTrucktyres)
  - Метод "каталог мотошин" (GetCatalogMototyres)
• Информация
  - Метод "регионы поиска" (GetRegionsV2)
  - Метод "производители авто" (GetBrandsV2)
  - Метод "статистика цен" (GetStatPricesV4)
  - Метод "мои данные" (GetMyInfoV2)
  - Метод "информация о продавце" (GetUserInfo)
  - Метод "отзывы о продавце" (GetRatingsV3)
  - Метод "статусы заказов" (GetCodesTrack)
• Регистрация и оформление заказа
  - Метод "регистрация" (MakeRegistration)
  - Метод "заказ и регистрация" (MakeRegistrationOrderV3)
  - Метод "сделать заказ" (MakeOrderV4)
• Для покупателя
  - Метод "мои заказы" (GetMyOrdersV3)
  - Метод "оставить отзыв по заказу" (MakeOrderRatingV2)
  - Метод "удалить отзыв" (DeleteRating)
• Для продавца
  - Метод "заказы от покупателей" (GetSellerOrdersV3)
  - Метод "обновление статуса заказа" (SetOrderStatusV3)
  - Метод "Отправка заказа от покупателя на сайт продавца (вэб-хуки)"
  - Метод "моя статистика" (GetMyStatCustomers)
  - Метод "Загрузка прайса" (UploadTemplatePrice)
• Корзина
  - Метод "моя корзина" (GetMyCart)
  - Метод "удалить из корзины" (DeleteFromCart)
  - Метод "редактирование корзины" (UpdateCartV2)
  - Метод "оформить заказы из корзины" (MakeOrdersCartV2)
  - Метод "обновить устаревший заказ в корзине" (ReplaceOldCartV2)
• Избранные позиции
  - Метод "добавление позиции в избранные" (AddFavoriteSearch)
  - Метод "удаление позиции из избранных" (DeleteFavoriteSearch)
  - Метод "мои избранные позиции" (GetMyFavoritesSearchV2)
• Сообщения
  - Метод "мои собеседники" (GetMyMessagesThreadsV3)
  - Метод "мои сообщения" (GetMyMessagesV3)
  - Метод "отправка сообщения" (SendMessageV2)
• Восстановление пароля
  - Метод "восстановление пароля" (RequestPasswordRecover)
• Удаление аккаунта
  - Метод "удаление аккаунта" (DeleteAccount)
• Отправка сообщения об ошибке
  - Метод "отправка сообщения об ошибке" (SendAppErrorMessage)
• Служебные методы
  - Метод "Версия мобильного приложения" (GetMobileAppVersion)
  - Метод "Регистрация устройства пользователя" (RegisterUserDevice)
  - Метод "Загрузка файла" (UploadFileV2)

История изменений 

версия 1.1 начальный выпуск - методы GetSearchSuggest, GetSearchResult, GetUserData, GetRegions
версия 1.2 добавлены методы MakeRegistration, MakeOrder, GetRatings, MakeOrderRating, GetMyOrders
версия 1.3 добавлена возможность отправки заказа от покупателя на сайт продавца, метод SetOrderStatus
версия 1.4 добавлены методы GetSellerOrders, GetMyInfo
версия 1.5 в методах GetSearchSuggest, GetSearchResult добавлено поле logopath (логотип производителя)
версия 1.6 добавлен метод GetStatPrices
версия 1.7 добавлен метод MakeRegistrationOrder
версия 1.8 добавлен метод MakeVinRequest
версия 1.9 добавлен метод GetBrands и поля addr_map_geo1 и addr_map_geo2 в метод GetSearchResult
версия 1.10 добавлены методы GetMyVinRequests, GetMyVinRequestReplies
версия 1.11 добавлен метод GetUserInfo, в методах GetMyOrders и GetMyVinRequestReplies добавлено поле user_key
версия 1.12 добавлены поля (на выход):
seller_rating_count, seller_rating, seller_address, seller_phone, seller_phone2, descr_price - в метод GetMyOrders
seller_rating_count, seller_rating, seller_address, seller_phone2 - в метод GetMyVinRequestReplies
версия 1.13 добавлены методы GetMySearchHistory, SetVinRequestStatus, GetSellerVinRequests; добавлено поле is_seller в метод GetMyInfo
версия 1.14 добавлен метод SendAppErrorMessage
версия 1.15 добавлены методы GetMyFavoritesSearch, AddFavoriteSearch, DeleteFavoriteSearch
версия 1.16 метод GetUserData "одно предложение" устарел, добавлен новый метод GetSearchResultOne
версия 1.17 методы GetMinPrices и GetAvgPrices устарели, пользуйтесь вместо них GetStatPrices
версия 1.18 добавлен метод GetSearchResultInfo
версия 1.19 добавлены методы GetSearchSuggestV2 (принимает новый параметр type_request) и GetSearchResultV2 (принимает новые параметры type_request и search_text)
GetSearchSuggestV2 и GetSearchResultV2 возвращают новое поле type_search
версия 1.20 добавлено поле (на выход) terms в метод GetSearchResultV2
версия 1.21 добавлен метод GetMyStatCustomers
версия 1.22 добавлено поле used в методы GetSearchResultV2, GetSearchResultOne, GetMyOrders, GetSellerOrders, GetSearchResult
версия 1.23 добавлены поля code_template и price_name в метод GetSellerOrders
версия 1.24 добавлены методы GetMyMessagesThreads, GetMyMessages, SendMessage и поле user_key в GetMyInfo
версия 1.25 добавлено поле accept_messages в методы GetUserInfo, GetSearchResultOne
версия 1.26 добавлен метод RequestPasswordRecover
версия 1.27 добавлены методы MakeOrderV2, MakeRegistrationOrderV2, MakeVinRequestV2, MakeOrderRatingV2, GetStatPricesV2 - на входе изменены типы полей:
в методах MakeOrderV2, MakeRegistrationOrderV2, MakeVinRequestV2 поля notifySms и test теперь bool
в методе MakeOrderRatingV2 поле test теперь bool
в методе GetStatPricesV2 поля instock, wholesale теперь bool
добавлены некоторые возвращаемые параметры:
в методах GetSearchResult, GetSearchResultV2, GetSearchResultOne - apply, min_sum_order, descr_min_sum_order, shipment, courier, price_orig, descr_price_orig, descr_type_price
в методах GetMyOrders , GetSellerOrders - min_sum_order, descr_min_sum_order, shipment, price_orig, descr_price_orig, descr_type_price
изменены типы некоторых возвращаемых параметров:
в методах GetSearchResult, GetSearchResultV2, GetSearchResultOne теперь это параметры instockV2, wholesaleV2, localV2, usedV2, priceV2, descr_priceV2
в методе GetMyOrders - usedV2, rated_orderV2, applyV2, priceV2, descr_priceV2
в методе GetSellerOrders - usedV2, applyV2, priceV2, descr_priceV2
версия 1.28 добавлены методы GetMyCart, DeleteFromCart, UpdateCart, MakeOrdersCart, ReplaceOldCart
добавлены поля qtyV2, qty_max, descr_qtyV2, delivery_days и descr_delivery в методы GetSearchResult, GetSearchResultOne, GetMyOrders, GetSellerOrders.
версия 1.29 добавлены поля priceV3 и descr_priceV3 в метод GetSearchResultOne
версия 1.30 добавлены поля type_user, type_user2 и type_price в методе GetSearchResult
поля commentV2, work_time, type_user, type_user2, type_price, telegram, whatsapp и viber в методах GetSearchResultOne и GetUserInfo
type_price в методах GetMyOrders и GetSellerOrders
версия 1.31 добавлены поля login и password в методах GetSearchSuggestV3, GetRegionsV2, GetRatingsV3, GetStatPricesV3, GetBrandsV2 и GetMobileAppVersionV2.
добавлено поле imagepathV2 в методах GetSearchSuggestV3, GetSearchResultV2, GetSearchResultOne, GetMyOrdersV2, GetSellerOrdersV2, GetMySearchHistoryV2, GetMyFavoritesSearchV2, GetSearchResultInfo и GetMyCart
добавлено поле descr_price_date в методе GetSearchResultV2
версия 1.32 добавлены новые версии методов GetSearchResultV3, GetSearchResultOneV2, UpdateCartV2, ReplaceOldCartV2, MakeOrderV3, MakeRegistrationOrderV3, GetSearchResultInfoV2, UpdateCartV2
в методе GetSearchResultV3 входной параметр location поменялся на code_region
в методах GetSearchResultOneV2, UpdateCartV2, ReplaceOldCartV2 появился входной параметр code_region
в методах MakeOrderV3, MakeRegistrationOrderV3, GetSearchResultInfoV2, UpdateCartV2 входной параметр currency поменялся на code_cur
в методе GetSellerOrders добавлен выходной параметр other_dests_count int, который обозначает, у скольких ещё продавцов заказана эта запчасть
версия 1.33 добавлены новые версии методов MakeOrderV4, MakeOrderCartV2 - появились входные параметры name_first, name_second, Name_last
версия 1.34 добавлена новая версия метода UploadFileV2 - появился входной параметр login_info (для внутренних целей)
версия 1.35 добавлены выходные параметры:
в методах GetSearchSuggest, GetSearchResult, GetSearchResultOne, GetMyOrders, GetSellerOrders, GetMyVinRequests, GetSellerVinRequests, GetMySearchHistory, GetMyFavoritesSearch, GetMyCart, GetSearchResultInfo - поле code_man
в методах GetMyOrders и GetSellerOrders - поля type_order и descr_type_order
версия 1.36 добавлено поле code_cat в GetMyOrdersV2 и GetMySearchHistoryV2
версия 1.37 добавлен метод UploadTemplatePrice
версия 1.38 добавлены новые версии методов GetMyOrderV3 и GetSellerOrdersV3 - появились входные параметры codes_track, date_from, date_to
версия 1.39 добавлен новый метод GetCatalogTyres
версия 1.40 добавлен новый метод GetSearchResultLight
версия 1.41 добавлен новый метод DeleteAccount
версия 1.42 добавлена новая версия метода GetStatPricesV4 - появились входные параметры used, delivery_periods
версия 1.43 добавлен новый метод DeleteRating
версия 1.44 добавлена новая версия метода GetRatingsV3 - появились выходные параметры code_rating, no_delete
версия 1.45 добавлены новые версии методов GetSearchResultV3 и GetSearchResultOneV2 - появились выходные параметры descr_rating_year_count, rating_year, descr_rating_total_count, rating_total