文档
测试

宝贝搜索

POST
https://gw.kuaimai.com/router

接口描述

宝贝搜索

调用入口

|调用环境|服务地址(HTTP/HTTPS)| |-|-| |正式环境|https://gw.kuaimai.com/router| |测试环境|http://pubgwerp.superboss.cc/router |

公共参数

|参数名称|参数类型|是否必须|参数描述| |-|-|-|-| |method|string|是|API接口名称| |appKey|string|是|分配给应用的AppKey| |timestamp|string|是|时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟| |format|string|否|响应格式。默认为json格式,可选值:json| |version|string|是|API协议版本 可选值:1.0| |sign_method|string|是|签名的摘要算法(默认 md5),可选值为:hmac,md5,hmac-sha256。| |sign|string|是|签名| |session|string|是|授权会话信息 (有系统分配)|

请求方法名

参数名
类型
描述
必填
method
string
tsj.item.search
必填

请求参数

参数名
类型
描述
必填
search
string
非必传; 搜索关键词; 示例:“帽子”(宝贝名称,宝贝id,宝贝链接)
必填
type
string
非必传; 店铺类型; 示例:“B”(淘宝:“C”,天猫:“B”,全部:“”)
必填
rangeList
array
非必传; 筛选条件区间集合
必填
key
string
必传; 筛选字段; 示例:“amount30” (销量:“amount30”,价格:“price”,默认是“amount30”)
必填
minValue
string
必传; 区间最小值; 示例:“501”
必填
maxValue
string
必传; 区间最大值; 示例:“1000”
必填
orderField
string
非必传; 排序字段; 示例:“amount30”(销量:“amount30”,价格:“price”,默认是“amount30”)
必填
orderType
string
非必传; 排序类型; 示例:“desc”(降序:“desc”,升序:“asc”,默认是“desc”)
必填
pageNo
number
必传; 页码; 示例:1(大于1,默认是1)
必填
pageSize
number
必传; 每页数量; 示例:10(大于1且小于200,默认是10)
必填
shopId
number
非必传; 店铺链接; 示例:“https://xiaomi.tmall.com/?spm=a220o.1000855.1997427721.d4918089.73c84be0vrfKZM”(店铺id和店铺链接如果都传以店铺id为准)
必填
shopUrl
string
非必传; 店铺id; 示例:104736810(店铺id和店铺链接都传以店铺id为准)
必填

响应结果

参数名
类型
描述
必填
data
data
搜索结果集合
必填
id
number
宝贝id; 示例:521075905461
必填
image
string
宝贝主图; 示例:"//img.alicdn.com/imgextra/i3/292405515/O1CN014kv5rs1qbuyDektEt_!!292405515.jpg"
必填
title
string
宝贝标题; 示例:"飞机盒长方形长条t12345超大小号批发礼盒lolita包邮防压纸箱淘宝"
必填
price
number
宝贝价格; 示例:1.06
必填
amount30
number
宝贝30天销量; 示例:84705
必填
shopId
number
店铺id; 示例:103237764
必填
type
string
店铺类型; 示例:"C"("B":天猫,"C":淘宝)
必填
sellerNick
string
卖家昵称; 示例:“天猫超市”
必填
shop
string
店铺名称; 示例:“天猫超市”
必填
total
number
总条数; 示例:1000
必填

返回示例

```javascript // 正常的数据返回 { "data": [{ "id": 21321979634, "image": "//img.alicdn.com/imgextra/i2/18658037050692097/T11epDFotaXXXXXXXX_!!0-item_pic.jpg", "title": "江苏移动话费充值50元 手机充值 充值卡 快充 秒充 充话费", "price": 49.9, "amount30": 10114495, "shopId": 104447777, "type": "B", "sellerNick": "朗盛话费充值专营店", "shop": "朗盛话费充值专营店" }], "total": 195, "success": true, "trace_id": "3188369440061504" } - 异常的数据返回 { "code": "40", "msg": "服务方法(last.insertDate.get:1.0)的应用键参数timestamp无效", "success": false, "trace_id": "382576054573568" } ```