Shop/ECJiaWiki:Api:goods/detail (o2o)

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取单个商品的详细信息

接口名称

 goods/detail

请求参数

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

举例如下

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

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 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 促销价格
└ 促销限购总数 promote_limited int 到家1.30新增 促销限购总数
└ 促销用户限购数 promote_user_limited int 到家1.30新增 促销用户限购数
└ 货品属性id product_goods_attr string 到家1.30新增 货品属性id
└ 货品id product_id int 到家1.30新增 货品id
└ 格式化促销价格 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 [] 规格
└货品规格信息 product_specification array 到家1.30新增 货品规格信息
   └货品id product_id int 货品id
   └货品编号 product_sn string 货品编号
   └货品属性id product_goods_attr string 货品属性id
   └货品库存 product_number int 货品库存
   └货品促销每人限购数 promote_user_limited int 货品促销每人限购数
   └货品价格 product_shop_price float 注:此处返回的价格api已计算处理过;用户端无需自己在累加计算属性价格 货品价格
   └货品价格(格式化) formatted_product_shop_price string 货品价格
   └是否促销 is_promote int 是否促销(0否1是)
   └货品促销价 promote_price int 货品促销价
   └货品促销价(格式化) formatted_promote_price string 货品促销价
└ 此商品是否在做团购活动 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 服务描述
└ 店铺信息 merchant_info merchant_info字典 店铺信息
└ 店铺id seller_id int 店铺id
└ 店铺名称 seller_name string 店铺名称
└ 商家电话 store_service_phone string 到家商城app时增加 商家电话
└ 店铺logo shop_logo string 店铺logo
└ 店铺商品数量 goods_count int 店铺商品数量
└ 店铺经营模式 manage_mode string 店铺经营模式
└ 店铺营业时间 label_trade_time string 到家小程序1.6时增加 店铺营业时间
└ 关注数 follower int 关注数
└ 评论信息 comment comment字典 评论信息
   └ 评论信息 comment comment字典 评论信息
      └ 商品好评率 comment_goods string 商品好评率
      └ 服务好评率 comment_server string 服务好评率
      └ 配送好评率 comment_delivery string 配送好评率

成功举例如下

{
    "data": {
        "id": "1314",
        "cat_id": 1035,
        "goods_sn": "ECS001314",
        "goods_name": "可乐",
        "collected": 0,
        "market_price": "¥6.00",
        "shop_price": "¥4.00",
        "integral": 0,
        "click_count": 40,
        "sales_volume": 0,
        "brand_id": 0,
        "goods_number": 1000,
        "goods_weight": "",
        "promote_price": "3.00",
        "promote_user_limited":10,             //到家1.30新增
        "promote_limited":20,                  //到家1.30新增
        "product_goods_attr":"4127|4128|4129", //到家1.30新增
        "product_id":72,                       //到家1.30新增
        "formated_promote_price": "¥3.00",
        "promote_start_date": "2019/04/02 00:00:00 +0800",
        "promote_end_date": "2019/05/04 00:00:00 +0800",
        "is_shipping": 0,
        "add_time": "",
        "img": {
            "thumb": "http://192.168.1.69/cityo2o/content/uploads/images/201903/goods_img/1314_G_1553107231695.jpg",
            "url": "http://192.168.1.69/cityo2o/content/uploads/images/201903/source_img/1314_G_1553107231695.jpg",
            "small": "http://192.168.1.69/cityo2o/content/uploads/images/201903/thumb_img/1314_G_1553107231695.jpg"
        },
        "is_on_sale": 1,
        "rank_prices": [
            {
                "id": 5,
                "rank_name": "注册用户",
                "unformatted_price": "5.00",
                "price": "¥5.00"
            },
            {
                "id": 6,
                "rank_name": "黄金会员",
                "unformatted_price": "4.00",
                "price": "¥4.00"
            },
            {
                "id": 7,
                "rank_name": "测试",
                "unformatted_price": "3.75",
                "price": "¥3.75"
            }
        ],
        "pictures": [
            {
                "small": "http://192.168.1.69/cityo2o/content/uploads/images/201903/goods_img/1314_P_1553107231293.jpg",
                "thumb": "http://192.168.1.69/cityo2o/content/uploads/images/201903/goods_img/1314_P_1553107231293.jpg",
                "url": "http://192.168.1.69/cityo2o/content/uploads/images/201903/source_img/1314_P_1553107231293.jpg?999"
            },
            {
                "small": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_img/81_P_1554932046093.jpg",
                "thumb": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_img/81_P_1554932046093.jpg",
                "url": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_source_img/81_P_1554932046093.jpg?999"
            },
            {
                "small": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_img/81_P_1554932056063.jpg",
                "thumb": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_img/81_P_1554932056063.jpg",
                "url": "http://192.168.1.69/cityo2o/content/uploads/images/201904/product_source_img/81_P_1554932056063.jpg?999"
            }
        ],
        "properties": [
            {
                "name": "商品库存",
                "value": 1000
            }
        ],
        "specification": [
            {
                "attr_type": 1,
                "name": "重量",
                "value": [
                    {
                        "label": "100g",
                        "price": "1",
                        "format_price": "¥1.00",
                        "id": 4216
                    },
                    {
                        "label": "150g",
                        "price": "2",
                        "format_price": "¥2.00",
                        "id": 4217
                    }
                ]
            },
            {
                "attr_type": 1,
                "name": "种类",
                "value": [
                    {
                        "label": "珍珠",
                        "price": "1",
                        "format_price": "¥1.00",
                        "id": 4218
                    }
                ]
            }
        ],
        "product_specification": [  //到家1.30.1新增
            {//有货品的情况
                "product_id": 81,
                "product_sn": "ECS001314g_p81",
                "product_goods_attr": "4216|4218",
                "product_number": 1000,
                "promote_limited":100,
                "promote_user_limited": 0,
                "product_shop_price": "10.00",   //注:此处返回的价格api已计算处理过;用户端无需自己在累加计算属性价格
                "formatted_product_shop_price": "¥10.00",
                "promote_price": 0,
                "formatted_promote_price": "",
            },
            {  //此种情况是商品有规格但没有添加货品
                "product_id": 0,
                "product_sn": "",
                "product_goods_attr": "4217|4218",
                "product_number": 0,
                "promote_limited":100,
                "promote_user_limited": 0,
                "product_shop_price": "7.00",   //注:此处返回的价格api已计算处理过;用户端无需自己在累加计算属性价格
                "formatted_product_shop_price": "¥7.00",
                "promote_price": 8,
                "formatted_promote_price": "¥8.00",
            }
        ],
        "unformatted_shop_price": "4.00",
        "groupbuy_info": [],
        "is_groupbuy": 0,
        "activity_type": "PROMOTE_GOODS",
        "goods_activity_id": 0,
        "saving_price": 1,
        "formatted_saving_price": "已省1元",
        "rec_type": "PROMOTE_GOODS",
        "object_id": 0,
        "goods_url": "https://cityo2o.ecjia.com/sites/m/index.php?m=goods&c=index&a=show&goods_id=1314&hidenav=1&hidetab=1",
        "favourable_list": [
            {
                "name": "新店开业",
                "type": "price_reduction",
                "type_label": "满减"
            },
            {
                "name": "春季促销",
                "type": "price_discount",
                "type_label": "满折"
            }
        ],
        "related_goods": [],
        "seller_id": 63,
        "merchant_info": {
            "seller_id": 63,
            "seller_name": "宅鲜配专营店",
            "shop_logo": "http://192.168.1.69/cityo2o/content/uploads/merchant/63/data/shop_logo/1502219493543820282.jpg",
            "store_service_phone": "15216670001",
            "goods_count": 43,
            "manage_mode": "self",
            "label_trade_time": "8:30--次日0:30",
            "follower": 0,
            "comment": {
                "comment_goods": "100%",
                "comment_server": "100%",
                "comment_delivery": "100%"
            }
        },
        "seller_name": "宅鲜配专营店",
        "server_desc": "由宅鲜配专营店发货并提供售后服务",
        "share_link": "https://cityo2o.ecjia.com/sites/m/index.php?m=goods&c=index&a=show&goods_id=1314&hidenav=1&hidetab=1",
        "goods_brief": ""
    },
    "status": {
        "succeed": 1
    }
}

失败举例如下

注:错误编码