企迈云-开放平台

API 2.0

API 2.0 > 3.3 商品规格 > 3.3.3 创建商品规格

3.3.3 创建商品规格

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：创建当前店铺的商品规格信息

零售餐饮

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	goods.spec-add	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
name	string	是	规格名称1-20位
category_id	int	否	商品类别编号
reta_values	array	否	规格值数组

响应参数

参数	参数类型	描述
data	array
├id	int	规格id
├category_id	int	商品类别编号
├name	string	规格名称
├updated_at	DateTime	更新时间
├created_at	DateTime	创建时间

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.spec-add",
    "Params": {
        "name": "规格名称",
        "category_id": "",
        "reta_values": "[1,2]"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "data": {
            "id": "",
            "category_id": "",
            "name": "",
            "updated_at": "",
            "created_at": ""
        }
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	goods.spec-add	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
name	string	是	规格名称1-20位
values	array	否
├0	array	否
├value	string	是	规格值 (当是零售时->是规格值数组可写成 Params[values][0] =“1111”)
├spec_value_sign	string	是	规格值编码
spec_sign	string	是	规格编码

响应参数

参数	参数类型	描述
status	bool	请求成功或者失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array
├id	int	规格id

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.spec-add",
    "Params": {
        "name": "规格名称",
        "values": [
            {
                "value": "[1,2]",
                "spec_value_sign": ""
            }
        ],
        "spec_sign": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "id": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}