Поисковая выдача

IMSHOP Retail Protocol (IRP) является объектом интеллектуальной собственности ООО «АЙ ЭМ СОЛЮШНЗ» (IMSHOP) и защищён как объект авторского права. Свидетельство о депонировании произведения № 023-014461 от 16 января 2023 г. подтверждает исключительные права ООО «АЙ ЭМ СОЛЮШНЗ» на данные технологии.

IMSHOP Retail Protocol создан по заказу ООО «АЙ ЭМ СОЛЮШНЗ». Использование IMSHOP Retail Protocol допустимо только при взаимодействии с ООО "АЙ ЭМ СОЛЮШНЗ" и наличии действующего лицензионного договора. Более подробно можно ознакомиться здесь.

Дополнительные интеграции вводятся в эксплуатацию после завершения основных интеграций:

Для подключения дополнительных интеграций обратитесь к вашему менеджеру в IMSHOP.IO

Поиск

Важно

Поисковая выдача может быть далее отфильтрована пользователем по цене и другим показателям (бренд, цвет и т.п.).

Запрос поиска идёт в паре с запросом фильтров. Нельзя отдельно реализовать запрос поиска без запроса фильтров.

Формат запроса

  • term — поисковый запрос

  • location — локация пользователя, объект «Местоположение»

  • page — страница выдачи; размер страницы по умолчанию — 10 товаров

  • sort — режим сортировки; значения: popular, price, discount; по умолчанию score

  • desc — сортировать по уменьшению; по умолчанию false

  • appliedFilters — примененные фильтры в формате id: value

{
    "term": "Стиральн",
    "location": {
        "city": "Москва",
        "cityFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
        "region": "Москва",
        "regionFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
    },
    "page": 1,
    "sort": "price",
    "desc": true,
    "appliedFilters": [
        { "brand": "Bosh" },
        { "brand": "Samsung" }
    ]
}

Формат ответа

  • items — список ID товаров из фида (group_id если есть, иначе id)

{
    "items": ["789887", "961551", "55598192"]
}

Фильтры

Запрос фильтров мало чем отличается от запроса поиска товаров.

Формат запроса

  • term — поисковый запрос

  • location — локация пользователя, объект «Местоположение»

  • appliedFilters — примененные фильтры в формате id: value

{
    "term": "Стиральн",
    "location": {
        "city": "Москва",
        "cityFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
        "region": "Москва",
        "regionFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
    },
    "appliedFilters": [
        { "brand": "Bosh" },
        { "brand": "Samsung" }
    ]
}

Формат ответа

  • filters — набор фильтров в формате:

    • id — идентификатор; будет далее использоваться в массиве appliedFilters

    • title — отображаемое название

    • type — тип; значения: checkbox; toggle; range

    • units — единицы измерения

    • numeric — фильтр численный

    • min — минимум

    • max — максимум

    • values — допустимые значения

{
  "filters": [
    {
      "id": "price",
      "max": 3990,
      "min": 290,
      "title": "Цена",
      "type": "range",
      "units": "Р"
    },
    {
      "id": "discounted",
      "title": "Товары со скидкой",
      "type": "toggle"
    },
    {
      "id": "age",
      "max": 0,
      "min": 0,
      "numeric": false,
      "title": "Возраст игроков",
      "type": "checkbox",
      "values": [
        "от 10",
        "от 12",
        "от 14",
        "от 6"
      ]
    }
  ]
}

Last updated