3.3 Получение формы с перечнем характеристик товара

На этом шаге происходит получение перечня характеристик товара (формы), которые необходимо заполнить для конкретной категории товаров на маркетплейсе.

GET-запрос:

curl -X 'GET' \
'https://halykmarket.kz/gw/merchant/public/form/product/feature?categoryId=43969' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ваш токен'

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

Наименование	Тип	Описание
categoryId	integer	ID категории 3-го уровня, которую вы получили на шаге 3.1

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

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

Набор полей в ответе зависит от того, какую категорию 3-го уровня вы отправили — форма характеристик описывает каждую категорию соответственно.

Атрибуты ответа представляют собой набор блоков с характеристиками:

Каждый блок характеристик включает в себя набор характеристик, так называемых атрибутов.

Система поддерживает 4 типа атрибутов: NUMBER, ENUM, STRING, BOOLEAN:

{
        "categoryId": 11111,	        // ID категории атрибутов
        "code": "11111-111",	        // код категории атрибутов
        "name": "Связь и интернет",     // название категории атрибутов
        "attrs": [		        // блок с атрибутами
            {
                "classAttrAssignmentId": 11111,                 // ID атрибута
                "code": "c0001-SII:c0001-GEN-STANDARTSVYAZI",   // код атрибута
                "classAttrType": "ENUM",                        // тип атрибута
                "required": false,                              // обязательность заполнения атрибута
                "attrValue": {                                  // объект со значением атрибута
                    "classAttributeId": 11111,                      // ID значения атрибута
                    "name": "Стандарт связи",                       // название значения атрибута
                    "code": "11111-GEN-STANDARTSVYAZI",             // код значения атрибута
                    "classAttrValues": [                            // возможные значения атрибута (тоько для ENUM-полей)
                        {
                            "classAttrValueId": "11111",                // ID значения атрибута
                            "code": "2G",	                        // код значения атрибута
                            "name": "2G"				// название значения атрибута
                        },
                        {
                            "classAttrValueId": "11111",		// ID значения атрибута
                            "code": "3G",				// код значения атрибута
                            "name": "3G"				// название значения атрибута
                        }
                    ]
                },
                "unit": null                                   // объект с единицами измерения (только для number-полей)
            },
            {
                "classAttrAssignmentId": 11111,                // ID атрибута
                "code": "c0001-SII:podderzhka-5g",             // код атрибута
                "classAttrType": "BOOLEAN",                    // тип атрибута
                "required": false,                             // обязательность заполнения атрибута
                "attrValue": {                                 // объект со значением атрибута
                    "classAttributeId": 11111,                     // ID значения атрибута
                    "name": "Поддержка 5G",			   // название значения атрибута
                    "code": "podderzhka-5g",			   // код значения атрибута
                    "classAttrValues": []			   // возможные значения атрибута (тоько для ENUM-полей)
                },
                "unit": null                                   // объект с единицами измерения (только для number-полей)
            },
            {
                "classAttrAssignmentId": 11111,                // ID атрибута
                "code": "11111-SII:c0001-SII-GPSnav",          // код атрибута
                "classAttrType": "STRING",                     // тип атрибута
                "required": true,                              // обязательность заполнения атрибута
                "attrValue": {                                 // объект со значением атрибута
                    "classAttributeId": 11111,                     // ID значения атрибута
                    "name": "Спутниковая навигация",               // название значения атрибута
                    "code": "11111-SII-GPSnav",                    // код значения атрибута
                    "classAttrValues": []                          // возможные значения атрибута (тоько для ENUM-полей)
                },
                "unit": null                                   // объект с единицами измерения (только для number-полей)
            },
            {
                "classAttrAssignmentId": 11111,                // ID атрибута
                "code": "11111-CAM:osnovnaja-kamera",          // код атрибута
                "classAttrType": "NUMBER",                     // тип атрибута
                "required": true,                              // обязательность заполнения атрибута
                "attrValue": {                                 // объект со значением атрибута
                    "classAttributeId": 11111,                     // ID значения атрибута
                    "name": "Основная камера",                     // название значения атрибута
                    "code": "osnovnaja-kamera",                    // код значения атрибута
                    "classAttrValues": []                          // возможные значения атрибута (тоько для ENUM-полей)
                },
                "unit": {                                      // объект с единицами измерения (только для number-полей)
                    "classAttrUnitId": 1111,                       // ID единицы измерения
                    "code": "х",                                   // код единицы измерения
                    "conversionFactor": null,                      // Технический параметр, всегда NULL 
                    "name": "Мпикс",                               // название единицы измерения
                    "symbol": null,                                // символ единицы измерения
                    "unitType": null                               // Технический параметр, всегда NULL
                }
        ]
    }

Вы получили форму характеристик товара, которую будете заполнять далее на шаге 3.5

Обратите внимание, что для заполнения формы характеристик товара вам понадобятся поля classAttrAssignmentId и classAttrValueId из формы выше.