开发指南
API
官网
API 2.0
API 2.0 > 3.1 商品 > 3.1.3 商品详情

3.1.3 商品详情

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：根据商品ID，获取当前商品的基本信息
餐饮 平台零售 平台餐饮

请求地址

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

公共参数

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

请求参数

参数 参数类型 是否必填 默认值 描述
id int 是 商品ID

响应参数

参数 参数类型 描述
status int 请求成功或者失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├goods array
  ├id Int 商品id
  ├name string 商品名称
  ├category_id Int 分类id
  ├brand_id Int 品牌id
  ├unit string 计量单位
  ├unit_type Money(分) 计量单位类型 1下单显示单位
  ├pack_cost Money(分) 打包费
  ├sale_type Int 组合标志位 售卖类型： 1-堂食 2-外卖 3-堂食和外卖
  ├out_sell_price Money(分) 外卖销售价格
  ├sell_price Money(分) 堂食销售价格
  ├out_market_price Money(分) 外卖市场价
  ├market_price Money(分) 堂食市场价格
  ├out_stock Int 外卖-库存
  ├stock Int 堂食-库存
  ├images array
   ├0 string 商品图片
  ├status Int 状态 0删除 1正常 2下架
  ├content string 商品描述
  ├sort Int 排序
  ├created_at TimeStamp 创建时间
  ├updated_at TimeStamp 更新时间
  ├specs array
   ├0 array
    ├id Int 规格id
    ├name string 规格名称
    ├values array
     ├0 array
      ├id Int 规格值id
      ├value string 规格值名称
  ├recommend Int 推荐位置
  ├collects Int 商品收藏次数
  ├use_spec Int 使用规格 1.使用 0.不使用 《套餐商品》为 0
  ├sales Int 产品销量
  ├freight_type Int 运费类型： 0统一运费， 1：运费模版
  ├freight Money(分) 运费
  ├freight_id Int 运费模版
  ├views Int 商品浏览量
  ├seo_title string seo标题
  ├seo_keywords string seo描述
  ├is_card_discount Int 0 不参与 1参与
  ├goods_type Int 商品类型 1:实物 2:虚拟物品
  ├buy_type Int 购买类型 1:站内购买 2:外部购买 3:不可购买
  ├filter_id Int 筛选项模版ID
  ├attribute_id Int 属性模版ID
  ├valid_period Int 商品有效期
  ├effective_type Int 电子凭证生效时间
  ├effective_delay_hours Int 多少小时后生效
  ├item_validity_start Int 有效期开始时间
  ├item_validity_end Int 有效期结束时间
  ├use_property Int 做法 0- 未使用 1- 使用 《套餐商品》为 0
  ├sell_time_status Int 是否开启分时段销售 0- 未开启 1- 开启
  ├production_time Int 商品制作时间
  ├cover_img string 封面图
  ├type Int 商品的销售类型 1表示普通商品 2表示套餐商品 3表示称重商品
  ├goods_subheading string 商品副标题
  ├use_material Int 使用加料: 0不使用 1使用《套餐商品》为 0
  ├entities array
   ├0 array
    ├id Int 实体id
    ├goods_id Int 商品id
    ├name string 实体名称
    ├product_no string 商品编码
    ├out_sell_price Money(分 外卖销售价格
    ├sell_price Money(分 堂食销售价格
    ├out_market_price Money(分 外卖市场价
    ├market_price Money(分 堂食市场价
    ├weight Int 产品重量
    ├out_stock Int 外卖-库存
    ├stock Int 堂食-库存
    ├spec array
     ├62 Array 规格id:规格值id
    ├spec_text array
     ├颜色 Array 规格文本 规格名称:规格值名称
    ├spec_id string 规格字符串 规格id:规格值id
    ├image string 实体图片
    ├trade_mark string 实体标识
    ├old_image string 原图片地址
  ├category_ids array
   ├0 array
    ├goods_id int 商品id
    ├category_id int 分类id
    ├name string 分类名称
  ├sell_time array
   ├0 array
    ├time array
     ├0 string 销售开始时段
     ├1 string 销售结束时段
  ├image string 商品图片
  ├old_images array
   ├0 string 原图片地址
 ├specs array
  ├0 array
   ├id int 规格id
   ├name string 规格名称
   ├valueShow int false
   ├selected array
    ├0 array
     ├id int 规格值id
     ├value string 规格值名称
     ├spec_id int 规格id
     ├spec_name string 规格名称
     ├status string 是否可选规格 true.是false.否
   ├status string 是否可选规格 true.是false.否
 ├specList array
  ├0 array
   ├id int 规格id
   ├category_id int 分类id
   ├name string 规格名称
   ├sort int 排序
   ├status int 状态 1.开启 0.关闭
   ├spec_sign string 规格编码
   ├values array
    ├0 array
     ├id int 规格值id
     ├spec_id int 规格id
     ├value string 规格值名称
     ├sort int 排序
     ├spec_value_sign string 规格值编码
 ├goodProperty array
  ├allProperty array
   ├0 array
    ├id int 所有的做法 做法id
    ├name string 做法名称
    ├values array
     ├0 array
      ├id int 做法值id
      ├value string 做法值名称
      ├property_id int 做法id
      ├select int 做法是否可选 1.可选 0.不可选
    ├select int 做法值是否可选 1.可选 0.不可选
  ├property array
   ├0 array
    ├id int 做法id
    ├name string 做法名称
    ├temp_status int 是否温度排序 1.是 0.否
    ├values array
     ├0 array
      ├id int 做法值id
      ├value string 做法值名称
      ├code string 规格值编码
      ├temp string 温度区间

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-detail",
    "Params": {
        "id": "商品ID"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "goods": {
            "id": "",
            "name": "",
            "category_id": "",
            "brand_id": "",
            "unit": "",
            "unit_type": "",
            "pack_cost": "",
            "sale_type": "",
            "out_sell_price": "",
            "sell_price": "",
            "out_market_price": "",
            "market_price": "",
            "out_stock": "",
            "stock": "",
            "images": [
                ""
            ],
            "status": "",
            "content": "",
            "sort": "",
            "created_at": "",
            "updated_at": "",
            "specs": [
                {
                    "id": "",
                    "name": "",
                    "values": [
                        {
                            "id": "",
                            "value": ""
                        }
                    ]
                }
            ],
            "recommend": "",
            "collects": "",
            "use_spec": "",
            "sales": "",
            "freight_type": "",
            "freight": "",
            "freight_id": "",
            "views": "",
            "seo_title": "",
            "seo_keywords": "",
            "is_card_discount": "",
            "goods_type": "",
            "buy_type": "",
            "filter_id": "",
            "attribute_id": "",
            "valid_period": "",
            "effective_type": "",
            "effective_delay_hours": "",
            "item_validity_start": "",
            "item_validity_end": "",
            "use_property": "",
            "sell_time_status": "",
            "production_time": "",
            "cover_img": "",
            "type": "",
            "goods_subheading": "",
            "use_material": "",
            "entities": [
                {
                    "id": "",
                    "goods_id": "",
                    "name": "",
                    "product_no": "",
                    "out_sell_price": "",
                    "sell_price": "",
                    "out_market_price": "",
                    "market_price": "",
                    "weight": "",
                    "out_stock": "",
                    "stock": "",
                    "spec": {
                        "62": ""
                    },
                    "spec_text": {
                        "颜色": "红"
                    },
                    "spec_id": "",
                    "image": "",
                    "trade_mark": "",
                    "old_image": ""
                }
            ],
            "category_ids": [
                {
                    "goods_id": "",
                    "category_id": "",
                    "name": ""
                }
            ],
            "sell_time": [
                {
                    "time": [
                        "",
                        ""
                    ]
                }
            ],
            "image": "https:\\\/\\\/img-shop.qmimg.cn\\\/s10155\\\/2019\\\/04\\\/10\\\/e4a12f9f81bd3e8f4d.jpg",
            "old_images": [
                "s10155\\\/2019\\\/04\\\/10\\\/e4a12f9f81bd3e8f4d.jpg"
            ]
        },
        "specs": [
            {
                "id": "",
                "name": "",
                "valueShow": "",
                "selected": [
                    {
                        "id": "规格值id",
                        "value": "规格值名称",
                        "spec_id": "规格id",
                        "spec_name": "规格名称",
                        "status": "false"
                    }
                ],
                "status": "true"
            }
        ],
        "specList": [
            {
                "id": "",
                "category_id": "",
                "name": "",
                "sort": "",
                "status": "",
                "spec_sign": "",
                "values": [
                    {
                        "id": "",
                        "spec_id": "",
                        "value": "",
                        "sort": "",
                        "spec_value_sign": ""
                    }
                ]
            }
        ],
        "goodProperty": {
            "allProperty": [
                {
                    "id": "",
                    "name": "",
                    "values": [
                        {
                            "id": "",
                            "value": "",
                            "property_id": "",
                            "select": ""
                        }
                    ],
                    "select": ""
                }
            ],
            "property": [
                {
                    "id": "",
                    "name": "",
                    "temp_status": "",
                    "values": [
                        {
                            "id": "",
                            "value": "",
                            "code": "",
                            "temp": ""
                        }
                    ]
                }
            ]
        }
    }
}

异常示例

{
    "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.goods-detail 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
id int 是 商品ID

响应参数

参数 参数类型 描述
status int 请求成功或者失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├id int 商品ID
 ├name string 商品名
 ├use_spec Money(元) 是否多规格 1-是 0-否
 ├sell_price Money(元) 售价
 ├takeout_price Money(元) 外卖价
 ├sales int 销量
 ├shelve_status int 上下架状态筛选 1-商家 0-下架
 ├verify_status int 审核状态筛选 0未提交审核 1待审核 2审核通过 3审核不通过
 ├sort int 排序，数字越小越靠前
 ├created_at DateTime 创建时间
 ├stock int 库存
 ├unit int 单位
 ├shelve_reason string 下架原因
 ├image string 主图
 ├entities array
  ├0 array
   ├id int 规格id
   ├name int 规格名
   ├product_no string 条码
   ├tag_name string 标签，多个标签空格分割
   ├sell_price Money(元) 售价
   ├takeout_price Money(元) 外卖价
   ├market_price Money(元) 市场价
   ├stock int 销量

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-detail",
    "Params": {
        "id": "商品ID"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "id": "",
        "name": "",
        "use_spec": "",
        "sell_price": "",
        "takeout_price": "",
        "sales": "",
        "shelve_status": "",
        "verify_status": "",
        "sort": "",
        "created_at": "",
        "stock": "",
        "unit": "",
        "shelve_reason": "",
        "image": "",
        "entities": [
            {
                "id": "",
                "name": "",
                "product_no": "",
                "tag_name": "",
                "sell_price": "",
                "takeout_price": "",
                "market_price": "",
                "stock": ""
            }
        ]
    }
}

异常示例

{
    "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.goods-detail 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
id int 是 商品ID

响应参数

参数 参数类型 描述
status int 请求成功或者失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├id int 商品ID
 ├name string 商品名
 ├use_spec Money(元) 是否多规格 1-是 0-否
 ├sell_price Money(元) 售价
 ├takeout_price Money(元) 外卖价
 ├sales int 销量
 ├shelve_status int 上下架状态筛选 1-商家 0-下架
 ├verify_status int 审核状态筛选 0未提交审核 1待审核 2审核通过 3审核不通过
 ├sort int 排序，数字越小越靠前
 ├created_at DateTime 创建时间
 ├stock int 库存
 ├unit int 单位
 ├shelve_reason string 下架原因
 ├image string 主图
 ├entities array
  ├0 array
   ├id int 规格id
   ├name int 规格名
   ├product_no string 条码
   ├tag_name string 标签，多个标签空格分割
   ├sell_price Money(元) 售价
   ├takeout_price Money(元) 外卖价
   ├market_price Money(元) 市场价
   ├stock int 销量

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-detail",
    "Params": {
        "id": "商品ID"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "id": "",
        "name": "",
        "use_spec": "",
        "sell_price": "",
        "takeout_price": "",
        "sales": "",
        "shelve_status": "",
        "verify_status": "",
        "sort": "",
        "created_at": "",
        "stock": "",
        "unit": "",
        "shelve_reason": "",
        "image": "",
        "entities": [
            {
                "id": "",
                "name": "",
                "product_no": "",
                "tag_name": "",
                "sell_price": "",
                "takeout_price": "",
                "market_price": "",
                "stock": ""
            }
        ]
    }
}

异常示例

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

错误码

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

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075