商品列表

作者 | 6月 26, 2023

2.商品列表

2.1应用场景

按贸易类型、分类、或商品名称搜索商品列表(一个商品一条记录)。

2.2注意事项
  • 接口调用需要间隔5秒一次。
2.3API内容

​ 基本信息(API接口)

API名称 /api/v2/goods/searchingGoods
功能描述 按分类获取商品列表(一个商品一条记录)

​ 基本信息(SDK接口)·

名称 HDServiceProvider.class# searchingGoods()
功能描述 按分类获取商品列表(一个商品一条记录)

​ 说明

  1. sort字段、direct字段说明:
    sort为空,按标签类型降序desc排序;
    sort不为空,direct也必须不能为空,按direct字段sort排序;
  2. 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

}

发表评论

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