请求HEADER
名称 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded;charset:utf-8; |
请求参数说明
名称 | 要求 | 类型 | 示例值 | 说明 |
---|---|---|---|---|
secret | 必填 | string | Ptjw1Du3l0t3JM10oD5I6fGOMV | 您的密钥,在密钥管理中查看 |
shop_id | 选填 | number | 1000004259 | 店铺ID,与卖家ID二选一 |
vender_id | 选填 | number | 10342182 | 卖家ID,与店铺ID二选一 |
page_num | 选填 | number | 1 | 页码 |
page_size | 选填 | number | 20 | 每页数据条数,最大值20 |
sort | 选填 | string | 0 | 排序方式, 0 -推荐排序 1-销量排序 2-价格由高到低 3-价格由低到高 4-评价排序 5-新品排序 |
keyword | 选填 | string | 搜索的关键词内容 |
响应HEADER
名称 | 值 | 说明 |
---|---|---|
X-Rate-Limit-Limit | 5 | 当前接口请求频率限额 |
X-Rate-Limit-Remaining | 2 | 一段时间内剩余允许请求数,该值为0表明达到当前接口最大请求频率/次数限制,应适当降低请求频率 |
X-Rate-Limit-Global | 1 | 该值为1表明触犯全局请求频率/次数限制,应适当降低请求频率 |
返回参数说明
名称 | 类型 | 说明 |
---|---|---|
code | number | 返回码,具体含义请参考错误码参照 |
msg | string | 返回说明 |
data | json | 返回结果集 |
rid | string | 请求ID |
JSON结果集返回示例
{"wareInfo":[{"preferentialPriceType":0,"groupId":"1000924","originPrice":"5.99","type":0,"preferentialDes":"","jumpUrl":"","integralActStock":false,"skuName":"舒可乐 卫生纸巾卷纸无芯小提装加厚家用卷筒纸手纸厕纸商用批发 14卷1提","isMaxMember":0,"track":"","skuId":"10059914868940","scribingPrice":"5.99","trackType":"2","selfGroupRec":0,"selfGroupPinCut":0,"imgUrl":"jfs/t1/167307/13/37897/56908/64bf499aFcb0d180d/e4f4c6d75901d5f5.jpg","currentTime":1694757088571,"allDataIndex":0,"labelList":[{"labelCode":"008","tags":["98%"]},{"labelCode":"009","tags":["不易松散"]}],"goodsPrice":"5.99"},......,{"preferentialPriceType":0,"groupId":"1000924","originPrice":"15.90","type":0,"preferentialDes":"","jumpUrl":"","integralActStock":false,"skuName":"舒可乐 卫生纸巾卷纸无芯小提装加厚家用卷筒纸手纸厕纸商用批发 36卷(12卷*3提)","isMaxMember":0,"track":"","skuId":"10056294160851","scribingPrice":"15.90","trackType":"2","selfGroupRec":0,"selfGroupPinCut":0,"imgUrl":"jfs/t1/80070/27/17128/87759/63610304E933e6c54/941ebf193354d2ef.jpg","currentTime":1694757088572,"allDataIndex":2,"labelList":[{"labelCode":"008","tags":["98%"]},{"labelCode":"009","tags":["不易松散"]}],"goodsPrice":"15.90"}],"lastPage":false,"pageIdx":1,"pageSize":20,"flag":"eyJpc0VuZCI6MCwibGFzdFBhZ2UiOmZhbHNlLCJwYWdlTGFzdEluZGV4IjoxOSwicnBjUGFnZUxhc3RJZCI6IjEwMDU5OTE0ODY4OTQzIiwic3RyYXRlZ3lUeXBlIjoiOSJ9"}
系统级错误码参照
错误码 | 说明 |
---|---|
500 | 缺少参数密钥KEY |
501 | 密钥KEY错误或已失效 |
502 | 密钥KEY已禁用,平台黑名单 |
503 | IP地址不被平台允许 |
504 | 接口不存在或已下线 |
505 | 接口维护中,请稍后访问 |
506 | 接口不支持该方式请求 |
507 | 接口不支持GET方式请求 |
508 | 接口不支持POST方式请求 |
509 | 服务端执行错误 |
510 | 服务端数据解析错误 |
服务级错误码参照
错误码 | 说明 |
---|---|
400 | 密钥KEY错误或已失效 |
401 | 密钥KEY已禁用 |
402 | IP地址不被用户允许 |
403 | 账号余额不足,请及时充值 |
404 | 超过当前接口每日调用限制 |
405 | 超过当前接口每秒调用限制 |
406 | 请求参数错误 |
407 | 请求失败,后端错误 |
错误码格式说明
5xx | 4xx | xx |
---|---|---|
系统级错误 | 服务级错误 | 具体错误代码 |