产品详情
API参数 电商商品信息查询 调用地址: http,https://goodsquery.api.bdymkt.com/channel/goods/query/datas 请求方式: POST 支持格式: application/json;charset=UTF-8 调用工具: 去调试 请求参数（Headers） 请求参数（Query） 请求参数（Body）
- 名称
- 类型
- 是否必须
- 示例值
- 描述
- channel
- string
- false
- taobao
- 通道编码：taobao、jd、vip等
- auth
- object
- false
- --
- 客户再平台端的授权信息：<br/>如果不填，默认是用快递100的账号；<br/>如果传入参数，就使用客户的授权信息
- appKey
- string
- false
- --
- --
- appSecret
- string
- false
- --
- --
- adzoneId
- null
- false
- --
- --
- pid
- string
- false
- --
- --
- search
- string
- false
- 女装
- 搜索的商品名称
- price
- object
- false
- --
- 商品价格区间：{"start":50,"end":100}
- start
- integer
- false
- 50
- --
- end
- integer
- false
- 100
- --
- coupon
- boolean
- false
- false
- 是否有优惠券：false表示不限
- dsr
- integer
- false
- 80
- 筛选店铺评分大于等于该值的商品，评分范围：0~100之间的值
- overseas
- boolean
- false
- false
- 是否海外商品：false表示不限
- catId
- integer
- false
- 11
- 商品筛选类目ID，根据不同渠道去获取相应的类目ID
- group
- boolean
- false
- false
- 是否拼购商品：false表示不限
- tmall
- boolean
- false
- false
- channel编码为taobao时表示是否为天猫商品：false表示不限
- jd
- boolean
- false
- false
- channel编码为jd时表示是否为京东自营：false表示不限
- page
- integer
- false
- 1
- 查询页数，默认为：1
- length
- integer
- false
- 20
- 每页返回数据条数，默认为：10
- sort
- string
- false
- ASC
- 排序类型：DESC：降序；<br/>ASC：升序
- field
- string
- false
- PRICE
- 排序字段：MATCH（匹配度）；<br/>PRICE（价格）；<br/>TOTAL_SALES（销量）；<br/>COMMISSION_RATE（佣金比率）；<br/>TOTAL_COMMISSION（佣金）；<br/>ORDER_COMMISSION（订单支出佣金）；<br/>ORDER_SALES（推广单量）
- t
- integer
- true
- 1621320507232
- 请求时间戳
- secret
- string
- true
- 54E5D70BE58A03A27E6E43806431E835
- 管理后台的secret编码，管理后台注册地址 https://api.kuaidi100.com/register/enterprise
- sign
- string
- true
- A6EE03010ABD2B7377BBA5138F4B4E80
- 加密签名，加密方式：MD5(t+key+secret)转大写，其中key、secret信息到企业管理后台获取
<dependency>
<groupId>com.baidubce</groupId>
<artifactId>api-explorer-sdk</artifactId>
<version>1.0.0</version>
</dependency>
import com.baidubce.http.ApiExplorerClient;
import com.baidubce.http.AppSigner;
import com.baidubce.http.HttpMethodName;
import com.baidubce.model.ApiExplorerRequest;
import com.baidubce.model.ApiExplorerResponse;
// 电商商品信息查询 Java示例代码
public class RequestDemo {
public static void main(String[] args) {
String path = "http://goodsquery.api.bdymkt.com/channel/goods/query/datas";
ApiExplorerRequest request = new ApiExplorerRequest(HttpMethodName.POST, path);
request.setCredentials("您的 access key", "您的 secret key");
request.addHeaderParameter("Content-Type", "application/json;charset=UTF-8");
String requestExample = "{\r\n\t\"channel\": \"taobao\",\r\n \"auth\": {\r\n \"appKey\": \"\",\r\n \"appSecret\": \"\",\r\n \"adzoneId\":\"\",\r\n \"pid\": \"\"\r\n },\r\n\t\"search\": \"女装\",\r\n\t\"price\": {\r\n\t\t\"start\": 50,\r\n\t\t\"end\": 100\r\n\t},\r\n\t\"coupon\": false,\r\n\t\"dsr\": 80,\r\n\t\"overseas\": false,\r\n\t\"catId\": 11,\r\n\t\"group\": false,\r\n\t\"tmall\": false,\r\n\t\"jd\": false,\r\n\t\"page\": 1,\r\n\t\"length\": 20,\r\n\t\"sort\": \"ASC\",\r\n\t\"field\": \"PRICE\",\r\n\t\"t\": 1621320507232,\r\n\t\"secret\": \"54E5D70BE58A03A27E6E43806431E835\",\r\n\t\"sign\": \"A6EE03010ABD2B7377BBA5138F4B4E80\"\r\n}";
request.setJsonBody(requestExample);
ApiExplorerClient client = new ApiExplorerClient(new AppSigner());
try {
ApiExplorerResponse response = client.sendRequest(request);
// 返回结果格式为Json字符串
System.out.println(response.getResult());
} catch (Exception e) {
e.printStackTrace();
}
}
}
点击复制代码
正常返回示例 {
"code": 200,
"data": {
"datas": [
{
"id": "602203425017",
"channel": {
"code": "taobao",
"name": "淘宝"
},
"title": "妈妈装夏装套装棉麻短袖t恤奶奶装大码阔腿裤60中老年女装两件套",
"description": "",
"picture": "https://img.alicdn.com/bao/uploaded/i1/1033905306/O1CN01LAZZl81p4CCIluy8t_!!1033905306.jpg",
"smallPic": "https://img.alicdn.com/bao/uploaded/i1/1033905306/O1CN01LAZZl81p4CCIluy8t_!!1033905306.jpg_200x200.jpg",
"searchId": "",
"volume": "244",
"superiorBrand": false,
"brandCode": "",
"brandName": "",
"location": "江苏 无锡",
"url": "//s.click.taobao.com/t?e=m%3D2%26s%3DLrsgR90gCCwcQipKwQzePOeEDrYVVa64lwnaF1WLQxlyINtkUhsv0PcBm%2BKmw0DJSu6lnpb%2BV8s%2FYGC4tRXBMqgTrTQtfNh5EiR0uj1%2Bxsd%2Bvz2d1F0xHC4gxH1zGZxu1GPduzu4oNrr28bjAg%2BpX%2B0k4%2BQhSeGgLFhaT%2BYyMXiQPb04V%2FJUfEkcdzTQpatDQFMqWCfRnHfGDmntuH4VtA%3D%3D&scm=null&pvid=100_11.139.248.201_14278_4561621390795252890&app_pvid=59590_33.5.185.117_811_1621390795248&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.139.248.201_14278_4561621390795252890;app_pvid:59590_33.5.185.117_811_1621390795248&xId=4aefZqtTxXVpQNt5OJu5sIcdhle3zrI4qE08wYDMSmBZJQyiIs9PjR17kdeJXQ8W2EpbVfHeLrA3WpqpoPuMLqGIzsfkCRS1DFNk39Hrf1vP&union_lens=lensId%3AMAPI%401621390795%402105b975_0893_179826c225c_88a9%4001",
"preSale": {
"feeText": "",
"startTime": 0,
"endTime": 0,
"tailStartTime": 0,
"tailEndTime": 0,
"deposit": "0"
},
"comments": 0
}
],
"total": 2097432,
"pageKey": ""
},
"message": "success",
"time": 465
}
失败返回示例 {
"code": 10005,
"message": "fail",
"time": 465
}
错误码定义 - code
- message
- status
- 描述
- 10005
- 数据不存在
- 10005
- 数据不存在
