商品详情

作者 | 6月 26, 2023

3.获取商品详情

3.1应用场景

根据传入的商品id获取商品详情(一个商品可能对应多个规格),以及每种规格的价格、库存、重量(包邮商品重量为0)、配货说明等详细信息。

3.2注意事项
  • 目前是测试环境可能商品数据不对
3.3API内容

​ 基本信息(API接口)

API名称 /api/v2/goods/getGoodsInfo
功能描述 根据传入的商品id(商品sn)获取商品详情列表(一个商品可能对应多个规格)

​ 基本信息(SDK接口)

名称 HDServiceProvider.class# getGoodsInfo()
功能描述 根据传入的商品id(商品sn)获取商品详情列表(一个商品可能对应多个规格)

​ 输入参数

变量名 含义 类型 备注
memberId 用户编号 string 必填@mock=90908
appkey number 必填@mock=21693225
goodsId 商品编号(2选1) string 必填@mock=11
needIntro 是否需要商品说明 1:表示需要说明 0:不需要说明 number 选填@mock=0
needFocusImages 是否需要焦点图(可选) number 选填@mock=1
goodsSn 商品货号(2选1,优先) string @mock=‘G323098’
needImages 是否需要橱窗图(可选) number 选填@mock=0
needActivity 是否需要促销信息(可选) number 选填@mock=0

​ 返回结果

变量名 含义 类型 备注
code 错误码 string @mock=’’
success boolean @mock=true
message string @mock=‘1’
data object
Activities|2 促销 array 促销信息
bigLogo 限时折扣大图标,原tagBigLogo string
endTime 活动结束时间,原tagEndTime字段取消 number @mock=$order(1519833600000,15
19833600000)
logo 限时折扣小图标,原taglogo string
name 活动名称,原tagName字段取消 string @mock=$order(‘新品抢鲜’,‘十月大促’)
shortName 活动段名称,原shortShortName字段 string @mock=特
startTime 活动开始时间,原tagBeginTime字段取消tagBeginTime number @mock=$order(1519833600000,15
19833600000)
tagId 活动Id number @mock=$order(15,100)
type 活动类型 number 5-限时折扣 6-满减送@mock=$order(5,6)
lockEnable —是否可锁货 number @mock=1
catName —类目名称 string @mock=爱他美
metaKeywords —SEO关键字 string
goodsId —商品编号 string @mock=11
isFreePost —是否包邮(1:是;0:否) number @mock=0
tagValid —标签是否生效 boolean @mock=true
metaDescription —SEO描述 string
brandId —品牌编号 string @mock=105
orderTagId —订单标签编号 string @mock=0
barCode —商品条形码(多个以逗号分割) string @mock=31020387234
seoKeywords —SEO平台搜索关键字 string
params —参数 string
sn —商品货号 string @mock=‘G1101000038’
tagLogo —标签小图 string
createTime —创建时间 number @mock=1519833600000
tagName —促销标签名称 string @mock=限时特卖
lastModifyDate —最后更新时间 number @mock=1430295823
isBuyLimit 是否达到购买上线0=不是,1=是 number @mock=1
originalPurchase 是否原价购买(活动原价购买) boolean 默认为false
images|9 —橱窗图列表(是否需要橱窗图) array
tinyPic ——微小图 string @mock=’http://img.seatent.com/static
s/attachment/goods/20160513173255
6681_small.jpg’
thumbnail ——缩略图 string @mock=‘http://img.seatent.com/static
s/attachment/goods/20160513173255
6681_small.jpg’
smallPic ——小图 string @mock=‘http://img.seatent.com/static
s/attachment/goods/20160513173255
6681_small.jpg’
bigPic ——大图地址 string
isDefault ——是否默认(1:是;0:否) number
remark —备注 string
tradeTypeName —贸易类型名称 string @mock=保税
subTitle —副标题 string @mock=保税直供
intro —商品详情 string @mock=’ 

bigPic —大图 string
tagBeginTime —促销标签开始时间 number @mock=1513242000000
unit —数量单位 string @mock=罐
countryId —国家编号 string @mock=83
enableStore —商品总库存(只需要库存信息) number @mock=123
weight —单件净重(克) number @mock=1100
maxGroup —最大组数限制 number @mock=0
disabled —是否禁用(0:不禁用;1:禁用) number @mock=0
isSupply —是否在售(1:是;0:否) number @mock=0
name —商品名称 string @mock=德国爱他美白金版pre段800g
pageTitle —SEO标题 string @mock=爱他美奶粉
min —最小件数限制 number @mock=0
tagEndTime —促销标签结束时间 number @mock=1513242000000
tinyPic —微小图片 string
minGroup —最小组数限制 number @mock=0
thumbnail —缩略图 string @mock=‘http://img.seatent.com/static
s/attachment/goods/20160513173255
6681_small.jpg’
cats —类目层级列表(是否需要类目) array
catOrder ——类目排序 number
parentId ——父类目编号 string
name ——类目名称 string
catPath ——类目编号路径 string
catId ——类目编号 string
expirationDate —有效期限(最近日期) number @mock=1519833600000
tradeType —贸易类型(1101保税、2202一般贸易、1303直邮、1404海外自提) number @mock=1101
smallPic —小图 string
brandName —品牌名称 string @mock=爱他美
orderDaily —单人单日订单限制 number @mock=0
tagShortName —标签段名称 string @mock=特
countryName —国家名称 string @mock=德国
tagBigLogo —标签大图 string
updateTime —更新时间 number @mock=1481523548000
catId —类目编号 string @mock=1101
tagId —促销标签编号 number @mock=284
tax —税率 number @mock=10
max —最大个数限制 number @mock=0
shelfLife —商品保质期 number @mock=12
result 结果(1:成功;0:失败) number @mock=1
3.4返回json串示例
{
    "code": "''",
    "data":
    {
        "activities": [
        {
            "bigLogo": "测试内容f3nr",
            "endTime": 1519833600000,
            "logo": "测试内容l968",
            "name": "新品抢鲜",
            "shortName": "特",
            "startTime": 1519833600000,
            "tagId": 15,
            "type": 5
        }
        ],
        "barCode": "31020387234",
        "bigPic": "测试内容5l1d",
        "brandId": 105,
        "brandName": "爱他美1",
        "canCreate": true,
        "catId": 1101,
        "catName": "爱他美",
        "cats": [
        {
            "catId": 88874,
            "catOrder": 83306,
            "catPath": "测试内容5812",
            "name": "测试内容7pb7",
            "parentId": 14063
        }
        ],
        "countryId": 83,
        "countryName": "德国",
        "createTime": 1519833600000,
        "disabled": 0,
        "enableStore": 123,
        "expirationDate": 1519833600000,
        "goodsId": 11,
        "images": [
        {
            "bigPic": "测试内容762o",
            "isDefault": 41726,
            "smallPic": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
            "thumbnail": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
            "tinyPic": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg"
        }
        ,
        {
            "bigPic": "测试内容762o",
            "isDefault": 41726,
            "smallPic": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
            "thumbnail": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
            "tinyPic": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg"
        }
    

        ],
        "intro": "<p><img align=\"absmiddle\" src=\"http://gd1.alicdn.com/imgextra/i1/2482209074/TB2m6BGcpXXXXcEXpXXXXXXXXXX_!!2482209074.jpg\" style=\"border: 0px; vertical-align: top; margin: 0px; padding: 0px; color: rgb(0, 0, 0); font-family: tahoma, arial, 宋体, sans-serif; font-size: 14px; line-height: 21px;\"/><img align=\"absmiddle\" src=\"http://gd3.alicdn.com/imgextra/i3/2482209074/TB2xNoxcpXXXXXfXXXXXXXXXXXX_!!2482209074.jpg\" style=\"border: 0px; vertical-align: top; margin: 0px; padding: 0px; color: rgb(0, 0, 0); font-family: tahoma, arial, 宋体, sans-serif; font-size: 14px; line-height: 21px; float: none;\"/></p>",
        "isBuyLimit": 0,
        "isFreePost": 0,
        "isSupply": 0,
        "lastModifyDate": 1430295823,
        "lockEnable": 1,
        "marketEnable": 1,
        "max": 0,
        "maxGroup": 0,
        "metaDescription": "测试内容a43i",
        "metaKeywords": "测试内容3muh",
        "min": 0,
        "minGroup": 0,
        "mktPrice": 389,
        "name": "德国爱他美白金版pre段800g",
        "orderDaily": 0,
        "orderTagId": 0,
        "originalPurchase": false,
        "pageTitle": "爱他美奶粉",
        "params": "测试内容76t9",
        "remark": "测试内容g7qn",
        "seoKeywords": "测试内容3p98",
        "shelfLife": 12,
        "smallPic": "测试内容w1v7",
        "sn": "‘G1101000038’",
        "subTitle": "测试内容o454",
        "tax": 10,
        "thumbnail": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
        "tinyPic": "测试内容o77v",
        "tradeType": 1101,
        "tradeTypeName": "保税",
        "unit": "罐",
        "updateTime": 1481523548000,
        "weight": 1100
    }
    ,
    "message": "'1'",
    "result": 1,
    "success": true

}

发表评论

您的电子邮箱地址不会被公开。