МылоПорошок — каталог mpshop.su

Найти товары в каталоге магазина бытовой химии и косметики «МылоПорошок» (Махачкала). Ищет по названию и синонимам, поэтому «гарнье» находит товары GARNIER. Можно сузить по категории, бренду и цене. По умолчанию отдаёт только то, что есть в наличии в магазинах сети. Возвращает название, бренд, цену в рублях, остаток, ссылку на карточку и фото.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Поисковая фраза, например «шампунь от перхоти» или «крем для рук»."
    },
    "category": {
      "type": "string",
      "description": "Категория: название или category_id из list_categories. Вложенные разделы включаются автоматически."
    },
    "brand": {
      "type": "string",
      "description": "Бренд: название или brand_id из list_brands."
    },
    "min_price": {
      "type": "number",
      "description": "Минимальная цена в рублях."
    },
    "max_price": {
      "type": "number",
      "description": "Максимальная цена в рублях."
    },
    "only_in_stock": {
      "type": "boolean",
      "description": "Только товары в наличии. По умолчанию true.",
      "default": true
    },
    "limit": {
      "type": "integer",
      "description": "Сколько товаров вернуть (1–30, по умолчанию 8).",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Полная информация о конкретном товаре: цена, штрихкод, артикул, бренд, путь категории, ссылка на карточку и остаток по каждому магазину сети. Ищет по product_id (из search_products) либо по штрихкоду EAN.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "description": "ID товара из ответа search_products."
    },
    "barcode": {
      "type": "string",
      "description": "Штрихкод EAN-8 или EAN-13 (цифры; ведущие нули значимы)."
    }
  },
  "additionalProperties": false
}

Разделы каталога. Без параметров — верхний уровень; передайте parent, чтобы получить подразделы. Используйте, когда нужно сузить поиск, а точное название категории неизвестно.

{
  "type": "object",
  "properties": {
    "parent": {
      "type": "string",
      "description": "Родительская категория: название или category_id."
    }
  },
  "additionalProperties": false
}

Бренды, представленные в магазине. Без параметров — весь список; с query — только подходящие по подстроке. Полезно, чтобы уточнить точное написание бренда перед поиском.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Часть названия бренда для фильтрации."
    }
  },
  "additionalProperties": false
}

Адреса, часы работы и координаты магазинов сети «МылоПорошок» в Махачкале. store_id из этого списка совпадает с идентификатором в остатках товара.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Собрать корзину из найденных товаров и получить одну ссылку: покупатель открывает её и видит готовую корзину на mpshop.su. До 20 позиций. Ничего не заказывает и не оплачивает — только формирует ссылку.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Позиции корзины, до 20 штук.",
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "integer",
            "description": "ID товара."
          },
          "quantity": {
            "type": "integer",
            "description": "Количество (1–99).",
            "minimum": 1,
            "maximum": 99,
            "default": 1
          }
        },
        "required": [
          "product_id"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}