Как добавить свой магазин на PartFinder

Для начала ваш магазин должен отвечать некоторым требованиям, магазин должен:
  • специализироваться на запчастях или аксессуарах для мобильных/носимых устройств: телефоны, планшеты, ноутбуки, медиаплееры; зарядные устройства, чехлы, наушники и т.п. для выше перечисленного
  • поддерживать поиск по своему каталогу товаров (с некоторыми фильтрами, например, фильтр наличия товара)
  • содержать актуальные сведения относительно цены, наличия в конкретном городе и качестве товара
Для добавления магазина на PartFinder нужно реализовать простое API для поиска на своем сайте:
[GET] /api?q=iphone&instok=1&page=2&results_on_page=30&city=0c5b2444-70a0-4932-980c-b4dc0d3f02b5
Response:
{
  page_count: 5,
  results_on_page: 25,
  page: 2,
  domain: "http://example.ru",
  results: [
    {
      product_id: "1515151",
      img: "/imgs/tovar/1515151/200px.jpg",
      title: "Iphone 5 дисплей",
      link: "/tovar/iphone_5_display",
      price: "100.00",
      instok: 1,
      count: 125,
      store: ["ТЦ Ромашка", "Ленина 78", "Склад №6"]
    }
  ]
}
Запрос:
используется GET-запрос (Content-Type: application/json; charset=UTF-8)
q* - поисковый запрос; обязательный параметр
instok* - фильтр наличия товара; instok=1 - показать товары только в наличии, instok=0 (или параметр не указан) - показать товары вне зависимости от наличия; обязательный параметр
page* - текущая страница с результатами (отсчёт от 1); обязательный параметр для реализации
results_on_page* - количество результатов на странице (например, сайт может поддерживать этот параметр от 1 до 100); по умолчанию 25-30 товаров; обязательный параметр
city - идентификатор(GUID) города по базе ФИАС; обязательный параметр если используется один домен для всех городов; узнать идентификатор можно на dadata.ru (набрав только название города) или скачать справочник ФИАС на сайте налог.ру
если каждый город поставщика расположен на отдельном домене или поддомене (например, msk.example.ru, spb.example.ru, rostov.example.ru), то параметр игнорируется
почему city в таком формате:
чтобы избежать конфликтов в наименовании городов у разных поставщиков - moskva, moscva, moscow, msk и т.д., у кого какая фантазия;
аналогично с одинаковыми названиями городов в разных областях (Благовещенск в Амурской области и в Башкортостане, Красноармейск в Московской и Саратовской областях и т.д.);
например, код ФИАС для Москвы 0c5b2444-70a0-4932-980c-b4dc0d3f02b5 - постоянный и уникальный


Ответ:
формат JSON
page_count* - количество страниц с результатами
results_on_page* - количество результатов на странице (равно параметру results_on_page из запроса)
page* - показанная страница результатов
domain* - домен сайта
results*:
product_id - код/артикул товара (необязательно)
img* - ссылка на изображение товара относительно корня сайта, если изображения нет - ссылка на заглушку или пустое поле; идеальный размер изображжения 150*150/200*200 пикселей
title* - наименование товара
link* - ссылка на страницу товара относительно корня сайта
price* - цена на товар в рублях без указания валюты и иных префиксов или постфиксов, разделитель - точка ("100", "999.99")
instok* - флаг наличия товара (1 или 0)
count - количество товара (0 или больше), необязательное поле
store - список магазинов города в которых есть товар, необязательно поле


Адрес API может отличаться от основного домена магазина, например:
API - api.example.ru
магазин example-msk.ru
параметры отмеченные * обязательные


Если возникли вопросы - напишите нам