Appearance

新建组合商品 ​

拥有此API的权限集
商品管理-增删改

请求方式及url ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://api.xiaoe-tech.com/xe.ecommerce.gms.cloud.create_combination_goods/1.0.0
  • 频率限制：10秒10次

接口调试

请求参数
响应结果
暂无响应数据

请求参数 ​

参数名必选类型说明
access_token是string专属token
resource_type是int资源类型标识（69:组合商品）
action_type是int操作类型（1:创建商品,2:编辑商品）
spu_name是string商品名称
goods_img是array[string]商品主图URL列表
goods_brief_text否string商品卖点简述
goods_detail_text否string商品详情文本
tags否array[int]商品分组标签列表
sale_status否int商品上架状态（0:下架,1:上架,2:定时上架还未上架阶段,3:待上架,4:强制下架）
is_display否int是否在店铺内展示（0:隐藏,1:展示）
is_stop_sell否int是否停止销售（0:否,1:是）
is_timing_sale否int是否定时上架（0:否,1:是）
timing_sale否string定时上架的时间
is_timing_off否int是否定时下架（0:否,1:是）
timing_off否string定时下架的时间
created_at否string创建时间(格式：YYYY-MM-DD HH:mm:ss)
sku是array[object]SKU列表
sku[].sku_name是stringSKU规格名称
sku[].sku_img否stringSKU规格图片URL
sku[].sku_price是intSKU规格价格
sku[].distribution_pattern是int配送方式（-1:全部 1:快递配送 2:自提）
sku[].is_uniform_freight是int是否是统一运费 (1:统一运费 2:运费模板)
sku[].freight是int运费金额，is_uniform_freight=1时必传，单位分
sku[].goods_img否array[string]SKU关联商品图片列表
sku[].freight_template_id否int运费模板ID，is_uniform_freight=2时必传
sku[].attr是array[object]SKU属性组合列表
sku[].attr[].spu_id是stringSPU唯一标识
sku[].attr[].sku_id是stringSKU唯一标识
sku[].attr[].period_type是int有效期类型（-1:跟随原商品,0:长期有效,1:具体时间前有效,2:有效期时间范围（秒））
sku[].attr[].period_value否string有效期值,例period_type=1时，值为日期(格式：YYYY-MM-DD HH:mm:ss),period_type=2时，值为秒数
sku[].attr[].sku_num是intSKU包含商品数量，不能小于1

请求示例 ​

{
    "access_token":"xe_xxxxx",
    "resource_type": 69,
    "action_type": 1,
    "spu_name": "xxxx组合商品",
    "goods_img": [
        "https://xxxx.jpg"
    ],
    "goods_brief_text": "123123123123",
    "goods_detail_text": "",
    "tags": [],
    "sale_status": 1,
    "is_display": 1,
    "is_stop_sell": 0,
    "is_timing_sale": 0,
    "timing_sale": "",
    "is_timing_off": 0,
    "timing_off": "",
    "created_at":"",
    "sku": [
        {
            "sku_name": "默认规格",
            "sku_img": "https://xxxx.jpg",
            "sku_price": 1,
            "distribution_pattern": -1,
            "is_uniform_freight": 1,
            "freight": 100,
            "goods_img": [],
            "freight_template_id": 0,
            "attr": [
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                },
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                }
            ]
        },
        {
            "sku_name": "规格2",
            "sku_img": "https://xxxx.jpg",
            "sku_price": 1,
            "distribution_pattern": -1,
            "is_uniform_freight": 1,
            "freight": 0,
            "goods_img": [],
            "freight_template_id": 0,
            "attr": [
                {
                    "spu_id": "g_676535ce9028e_JByDSqf0",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                },
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1,
                }
            ]
        }
    ]
}

返回参数 ​

参数名必选类型说明
code是int状态码（0表示成功）
msg是string消息描述（"ok"表示成功）
data是object响应数据对象
data.app_id是stringapp_id
data.spu_id是stringSPU唯一ID
备注 ​
  • code=0时，msg:
  • code!=0时，msg:拉取数据错误

返回示例 ​

{
    "code": 0,
    "msg": "success",
    "data": {
        "app_id": "appxxxx",
        "spu_id": "SPU_COP_xxxx"
    }
}