ECJiaWiki:Api:Goods/detail

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取单个商品的详细信息

接口名称

 goods/detail

请求参数

字段名 变量名 必填 类型 示例值 描述
token请求凭证 token String 79218f8e710fc755a222de45f43c3fd969b87972 调用接口凭证
商品id goods_id Int 商品id
商品活动id goods_activity_id Int 到家1.18新增 商品活动id(团购商品需要)

举例如下

{
      "token" : "79218f8e710fc755a222de45f43c3fd969b87972",
      "goods_id" : 1,
      "goods_activity_id" : 1
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status status字典 {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data data字典 请求接口提供的返回信息
└ 商品id id Int 商品id
└ 商品分类id cat_id Int 商品分类id
└ 商品编号 goods_sn String 商品编号
└ 商品名 goods_name String 商品名
└ 用户是否收藏 collected Int 用户是否收藏
└ 市场价格 market_price String 市场价格
└ 门店价格 shop_price String 门店价格
└ 积分 integral Int 积分
└ 点击数 click_count Int 点击数
└ 品牌id brand_id Int 品牌id
└ 商品库存数量 goods_number Int 商品库存数量
└ 商品的重量 goods_weight String 商品的重量
└ 促销价格 promote_price String 促销价格
└ 格式化促销价格 formated_promote_price String 格式化促销价格
└ 促销开始时间 promote_start_date String 促销开始时间
└ 促销结束时间 promote_end_date String 促销结束时间
└ is_shipping is_shipping Int is_shipping
└ 图片信息 img img字典 图片信息
   └ 缩略图 thumb String 缩略图
   └ 原图 url String 原图
   └ 小图 small String 小图
└ 会员等级价格信息 rank_prices array 会员等级价格信息
   └ 会员等级id id Int 会员等级id
   └ 会员等级名称 rank_name String 会员等级名称
   └ 当前会员等级对应商品价格 unformatted_price String 17.10 当前会员等级对应商品价格
   └ 格式化会员等级价格 price String ¥17.10 格式化的会员等级价格
└ 商品相册 pictures array 商品相册
   └ 小图 small String 小图
   └ 原图 url String 原图
   └ 缩略图 thumb String 缩略图
└ 属性 properties String 属性
   └ 属性名 name String 属性名
   └ 属性值 value String 属性值
└ 规格 specification array [] 规格
└ 此商品是否在做团购活动 is_groupbuy int 到家1.18新增 此商品是否在做团购活动(0否1是);别的地方进入商品详情时显示普通价格;is_groupbuy是1的话,可点击标签进入团购列表
└ 商品活动类型 activity_type String GENERAL_GOODS 活动类型(GENERAL_GOODS普通商品,GROUPBUY_GOODS团购商品,PROMOTE_GOODS促销商品)
└ 商品活动id goods_activity_id int 到家1.18新增 商品活动id(activity_type为GROUPBUY_GOODS时,代表团购活动的id)
└ 购物车类型 rec_type String 购物车类型
└ 节省价格 saving_price Decimal 节省价格
└ 团购信息 groupbuy_info groupbuy_info字典 到家1.18新增 团购信息
   └ 团购活动id activity_id int 团购活动id
   └ 团购保证金 deposit float 团购保证金(0表示没有保证金)
   └ 团购保证金(格式化) formated_deposit string 团购保证金
   └ 团购限购数量 resitrict_num int 团购限购数量(0表示不限购)
   └ 还剩可团购数量 left_num int 还剩可团购数量(不限购时返回null)
   └ 团购活动说明 groupbuy_activity_desc string 团购活动说明
   └ 团购阶梯价 groupbuy_price_ladder string 团购阶梯价
└ 商品链接 goods_url String 商品链接
└ 满减满折信息 favourable_list Array() 满减满折信息
└ 详情页猜你喜欢的商品信息 related_goods Array() 详情页猜你喜欢的商品信息
   └ 商品id goods_id Int 613 商品id
   └ 商品名 name String 商品名
   └ 市场价格 market_price String 市场价格
   └ 门店价格 shop_price String 门店价格
   └ 促销价格 promote_price String 促销价格
   └ 图片信息 img img字典 图片信息
      └ 缩略图 thumb String 缩略图
      └ 原图 url String 原图
      └ 小图 small String 小图
   └ 商品属性 specification array 1.4新增
   └ 节省价格 saving_price String 节省价格
   └ 节省价格(格式化) formatted_saving_price String 节省价格(格式化)
   └ 入驻商id seller_id Int 入驻商id
   └ 入驻商名称 seller_name String 入驻商名称
└ 服务描述 server_desc String 服务描述

成功举例如下

{
    "data": {
        "id": "613",
        "cat_id": "1092",
        "goods_sn": "ECS000613",
        "goods_name": "意大利多洛米亚充气型天然饮用水(玻璃瓶)330ml",
        "collected": 0,
        "market_price": "¥21.59",
        "shop_price": "¥18.00",
        "integral": 0,
        "click_count": "2",
        "brand_id": "0",
        "goods_number": "1000",
        "goods_weight": "0克",
        "promote_price": 0,
        "formated_promote_price": "¥0.00",
        "promote_start_date": "",
        "promote_end_date": "",
        "is_shipping": "0",
        "img": {
            "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_G_1459106283668.jpg",
            "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/source_img/613_G_1459106283964.jpg",
            "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/thumb_img/613_thumb_G_1459106283417.jpg"
        },
        "rank_prices": [
            {
                "id": 1,
                "rank_name": "铜牌",
                "unformatted_price": "18.00",
                "price": "¥18.00"
            },
            {
                "id": 2,
                "rank_name": "银牌",
                "unformatted_price": "17.10",
                "price": "¥17.10"
            },
            {
                "id": 3,
                "rank_name": "代销用户",
                "unformatted_price": "10.80",
                "price": "¥10.80"
            },
            {
                "id": 4,
                "rank_name": "金牌",
                "unformatted_price": "15.30",
                "price": "¥15.30"
            }
        ],
        "pictures": [
            {
                "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106283037.jpg",
                "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106283037.jpg",
                "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/source_img/613_P_1459106283089.jpg?1"
            },
            {
                "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106288576.jpg",
                "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106288576.jpg",
                "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/source_img/613_P_1459106288274.jpg?2"
            },
            {
                "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106289754.jpg",
                "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_P_1459106289754.jpg",
                "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/source_img/613_P_1459106289779.jpg?3"
            }
        ],
        "properties": [],
        "specification": [
            {
                "attr_type": "1",
                "name": "产地",
                "value": [
                    {
                        "label": "国产",
                        "price": "0",
                        "format_price": "¥0.00",
                        "id": "3770"
                    },
                    {
                        "label": "进口",
                        "price": "10",
                        "format_price": "¥10.00",
                        "id": "3771"
                    }
                ]
            },
            {
                "attr_type": "1",
                "name": "重量",
                "value": [
                    {
                        "label": "1kg",
                        "price": "0",
                        "format_price": "¥0.00",
                        "id": "3772"
                    },
                    {
                        "label": "2kg",
                        "price": "30",
                        "format_price": "¥30.00",
                        "id": "3773"
                    }
                ]
            }
        ],
        "unformatted_shop_price": "18.00",
        "activity_type": "GENERAL_GOODS",
        "object_id": 0,
        "saving_price": 0,
        "groupbuy_info":{
                 "activity_id":81,
                 "deposit":"100.00",
                 "formated_deposit":"¥100",
                 "resitrict_num":50,
                 "left_num":29,
                 "groupbuy_activity_desc":"测试哈哈",
                 "groupbuy_price_ladder":"满2份20元,满5份15元",
        },
        "formatted_saving_price": "已省0元",
        "rec_type": "GENERAL_GOODS",
        
        "goods_url": "http://test.b2b2c.ecjia.com/sites/touch/?goods&c=index&a=show&id=613&hidenav=1&hidetab=1",
        "favourable_list": [],
        "related_goods": [
            {
                "goods_id": "325",
                "name": "轩尼诗XO第六代珍藏版礼盒1500ml限量版 原装进口洋酒 干邑白兰地",
                "market_price": "¥7797.59",
                "shop_price": "¥6498.00",
                "promote_price": "",
                "img": {
                    "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201508/goods_img/325_G_1440359162568.png",
                    "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201508/source_img/325_G_1440359162810.png",
                    "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201508/thumb_img/325_thumb_G_1440359162842.png"
                },
                "specification": [
                            {
                                "attr_type": "1",
                                "name": "产地",
                                "value": [
                                    {
                                        "label": "国产",
                                        "price": "0",
                                        "format_price": "¥0.00",
                                        "id": "3770"
                                    },
                                    {
                                        "label": "进口",
                                        "price": "10",
                                        "format_price": "¥10.00",
                                        "id": "3771"
                                    }
                                ]
                            },
                            {
                                "attr_type": "1",
                                "name": "重量",
                                "value": [
                                    {
                                        "label": "1kg",
                                        "price": "0",
                                        "format_price": "¥0.00",
                                        "id": "3772"
                                    },
                                    {
                                        "label": "2kg",
                                        "price": "30",
                                        "format_price": "¥30.00",
                                        "id": "3773"
                                    }
                                ]
                            }
                        ],
                "activity_type": "GENERAL_GOODS",
                "object_id": 0,
                "saving_price": 1299.59,
                "formatted_saving_price": "已省1299.59元",
                "seller_id": "0",
                "seller_name": ""
            }
        ],
        "seller_id": "0",
        "server_desc": "由ECJia百货商城从总店发货并提供售后服务"
    },
    "status": {
        "succeed": 1
    }
}

失败举例如下

注:错误编码