2.1 Поиск товара по названию или артикулу

Этот шаг позволяет найти существующий товар на Halyk Market, чтобы затем привязать к нему свой. Поиск выполняется по названию или артикулу — например, «iPhone» или «Samsung A55».

GET-запрос:

curl -X 'GET' \
'https://halykmarket.kz/gw/merchant/public/skus/search?q=iPhone&page=1&size=20' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ваш токен'

Атрибуты запроса:

Наименование	Тип	Описание
q	string	Поисковый запрос — название или артикул искомого товара
page	integer	Пагинация: номер страницы с результатами ответа. Минимальное значение — 1
size	integer	Пагинация: количество результатов на странице. Минимальное значение — 1

Для обращения на тестовый сервер используйте URL: https://test2.halykmarket.com/gw/merchant/public/skus/search

Ответ от сервера (неполный скрин):

Шаблон ответа:

{
    "content": [
        {
            "skuId": 1111111111,
            "name": "Смартфон Apple iPhone 15 Pro 256Gb Black Titanium",
            "imageUrl": "/cmsstatic/1208168055/1208168055-blk1.jpg",
            "category": {
                "id": 11111,
                "name": "Смартфоны",
                "level": 3
            },
            "marketUrl": "/category/smartfoni/smartfon-apple-iphone-15-pro?sku=256gb_black-titanium"
        },
        {
            "skuId": 1111111111,
            "name": "Смартфон Apple iPhone 15 Pro 256Gb Black Titanium +Адаптер Apple Double USB-C 35W +Чехол +Защитное стекло",
            "imageUrl": "/cmsstatic/product/1207743464/product-1207743464-blc.jpg",
            "category": {
                "id": 11111,
                "name": "Акция 1+1 Электроника",
                "level": 3
            },
            "marketUrl": "/category/akcija-11/smartfon-apple-iphone-15-pro-256gb-black-titanium--adapter-apple-double-usb-c-35w--chehol--zashhitnoe-steklo"
        }
    ],
    "pageable": {
        "pageNumber": 0,
        "pageSize": 20,
        "sort": {
            "empty": true,
            "sorted": false,
            "unsorted": true
        },
        "offset": 0,
        "unpaged": false,
        "paged": true
    },
    "last": true,
    "totalPages": 1,
    "totalElements": 2,
    "size": 20,
    "number": 0,
    "sort": {
        "empty": true,
        "sorted": false,
        "unsorted": true
    },
    "first": true,
    "numberOfElements": 2,
    "empty": false
}

Атрибуты ответа:

Наименование	Тип	Описание
skuId	integer	Уникальный идентификатор товара, который будет необходим на следующем шаге
name	string	Наименование товара
imageUrl	string	Ссылка на изображение товара
category.id	integer	Идентификатор категории 3-го уровня
category.name	string	Наименование категории 3-го уровня
category.level	integer	Уровень категории, всегда равен 3
category.marketUrl	string	Ссылка на товар на маркете
pageNumber	integer	Номер текущей страницы
pageSize	integer	Размер страницы, указанный в запросе
totalPages	integer	Количество страниц с результатами
totalElements	integer	Количество товаров согласно запросу
—	—	Прочие поля несут технический характер

Вы получили перечень skuId в ответе запроса. Выберите тот, который соответствует вашему товару по названию, чтобы привязать свой товар к нему на следующем шаге