2.商品列表
2.1应用场景
按贸易类型、分类、或商品名称搜索商品列表(一个商品一条记录)。
2.2注意事项
- 接口调用需要间隔5秒一次。
2.3API内容
基本信息(API接口)
API名称 | /api/v2/goods/searchingGoods |
---|---|
功能描述 | 按分类获取商品列表(一个商品一条记录) |
基本信息(SDK接口)·
名称 | HDServiceProvider.class# searchingGoods() |
---|---|
功能描述 | 按分类获取商品列表(一个商品一条记录) |
说明
- sort字段、direct字段说明:
sort为空,按标签类型降序desc排序;
sort不为空,direct也必须不能为空,按direct字段sort排序;- tradeType
1101:保税
2202:一般贸易
1303:直邮
1404:海外自提
输入参数
变量名 | 含义 | 类型 | 备注 |
---|---|---|---|
keyword | 关键字(商品名称或品牌或货号等) | string | 选填 |
memberId | 用户ID | string | 必填@mock= bf3ea2428fa73434068c661106980b70ff4c8fd70 |
appkey | number | 必填 | |
catId | 分类编号 | string | 选填 |
pageSize | 页面大小数量 | number | 选填@mock=10,禁止超过50 |
pageNum | 页面数量(第n页) | number | 选填@mock=1 |
brandId | 品牌编号 | string | 选填 |
tradeType | 贸易类型(1101,2202,3303,1404) | string | 选填,支持多个贸易类型以逗号隔开 |
ignoreStock | 是否忽略库存为0的商品 | string | 选填,传1显示库存为0商品 |
返回结果
*变量名* | *含义* | *类型* | *备注* |
---|---|---|---|
message | string | @mock=”” | |
result | 结果(1:成功;0:失败) | number | @mock=1 |
data | object | ||
result|7 | 结果集 | array | |
big | 商品大图 | string | @mock=http://img.seatent.com/statics/atta chment/goods/201605131732556681_small.jpg |
brandId | 品牌编号 | string | @mock=$order(265,0,106,0,256,105,0) |
brandName | 品牌名称 | string | @mock=$order(‘美林’,‘undefined’,‘迪尔玛’,‘爱他美1’,‘undefined’) |
buyNum | 销量(已售数量) | number | @mock=222 |
catId | 分类编号 | string | @mock=$order(1101,1502,1110,1401,180 2,1101,2029) |
catName | 分类名称 | string | @mock=$order(‘爱他美’,‘宝宝护肤’,‘其他品 牌’,‘奶瓶奶嘴’,‘饮品’,‘爱他美’,‘坐垫’) |
countryId | 产地编号 | number | @mock=$order(151,1,151,228,200,83,) |
countryName | 产地名称 | string | @mock=$order(‘荷兰’,‘其他’,‘荷兰’,‘美国’,‘斯 里兰卡’,‘德国’) |
enableStore | 总库存 | number | @mock=$order(100,1000,93,37,211,109,940) |
goodsId | 商品编号 | string | @mock=650 |
hotSort | 商品热度 | number | 热门商品排序 0:非热门商品,>0 数值越大排名 越靠前 |
isFreepost | 是否包邮(1:是;0:否) | number | @mock=1 |
life | 有效期(最近) | string | @mock=2018-06-30 |
mktprice | 市场价格 | number | @mock=$order(282.9,338,50,650,1) |
name | 商品名称 | string | @mock=“荷兰奶粉” |
orderTagId | 订单标签编号 | number | @mock=1007 |
originalPrice | 商品原价 | number | @mock=$order(5,11.1,12,110,32,557,15) |
pCatId | 父分类编号 | string | @mock=$order(1100,1500,1100,1400,1800,1 100,2028) |
pCatName | 父分类名称 | string | @mock=奶粉 |
num | —规格数量 | number | @mock=2 |
price | —规格价格(有活动包含活动优惠) | number | @mock=-2 |
price | 商品优惠后的最低金额 | number | @mock=100 |
small | 小图片 | string | @mock=$order(‘http://img.seatent.com/static s/attachment/goods/201605131732556681_s mall.jpg’ |
sn | 商品货号 | string | @mock=$order(‘HD1101002807’,‘HD0000254 9’,‘HD1110000005’,‘HD1401000004’) |
tagBigLogo | 活动大logo | string | @mock=$order(‘http://img.seatent.com/static s/attachment/tagImage/201706191437428701.png’ |
tagId | 活动编号 | number | @mock=$order(264,1012,0,0,0,0,0) |
tagLogo | 活动logo | string | @mock=$order(‘http://img.seatent.com/static s/attachment/tagImage/201706191437428701.png’ |
tagName | 活动名称 | string | @mock=”新品特惠” |
tagSort | 活动排序 | number | @mock=$order(111,1,) |
tagValid | 活动是否生效 | boolean | @mock=true |
tax | 税率 | number | @mock=$order(11.9,0,10,10,0,0,0) |
thumbnail | 缩略图 | string | @mock=$order(‘http://img.seatent.com/static s/attachment/goods/20160513173255668 1_small.jpg |
tiny | 微小图 | string | @mock=$order(‘http://img.seatent.com/static s/attachment/goods/20160513173255668 1_small.jpg |
tradeType | 贸易类型(1101保税、2202一般贸易、1303直邮、1404海外自提) | number | @mock=$order(2202, 1101, 1101, 1101, 220 2, 1303, 2202) |
tradeTypeName | 贸易类型名称 | string | @mock=$order(‘一般贸易’,‘保税’,‘保税’,‘保税’,‘一 般贸易’,‘直邮’,‘一般贸易’) |
totalCount | —总数量 | number | @mock=7 |
pageSize | —每页数量 | number | @mock=10 |
totalPageCount | —总页面数 | number | @mock=1 |
currentPageNo | —当前页面no | number | @mock=1 |
success | boolean | @mock=true | |
code | 错误码 | string | @mock=”” |
2.4返回json串 示例
{
"code": "",
"data":
{
"currentPageNo": 1,
"facet":
{
"brandCountList": [
1,
1,
1,
1
],
"brandIdList": [
"105",
"106",
"256",
"265"
],
},
"pageSize": 10,
"result": [
{
"activeEnableStore": 10,
"big": "测试内容j7us",
"brandId": 0,
"brandName": "undefined",
"buyNum": 222,
"catId": 1401,
"catName": "奶瓶奶嘴",
"countryId": 228,
"countryName": "美国",
"enableStore": 37,
"goodsId": 256,
"hotSort": 20584,
"isFreepost": 0,
"life": "测试内容pnk8",
"mktprice": 338,
"name": "thinkbaby不锈钢餐具套装(橙色)",
"orderTagId": 0,
"originalPrice": 110,
"pCatId": 1400,
"pCatName": "喂养用品",
"preferentialPrice": 22865,
"price": 85,
"small": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
"sn": "HD1401000004",
"tagBigLogo": "undefined",
"tagId": 0,
"tagLogo": "undefined",
"tagName": "undefined",
"tagValid": true,
"tax": 10,
"thumbnail": "http://img.seatent.com/statics/attachment/goods/201605131732556681_small.jpg",
"tiny": "fs:/attachment/goods/201508201237529432_tiny.jpg",
"tradeType": 1101,
"tradeTypeName": "保税"
}
],
"totalCount": 7,
"totalPageCount": 1
}
,
"message": "",
"result": 1,
"success": true
}