产品详情
API参数 即时查询API 调用地址: http,https://kdniao.api.bdymkt.com/express/track 请求方式: POST 支持格式: application/json;charset=UTF-8 调用工具: 去调试 请求参数（Headers） 请求参数（Query）
- 名称
- 类型
- 是否必须
- 示例值
- 描述
- ShipperCode
- string
- true
- null
- 快递公司编码
- LogisticCode
- string
- true
- null
- 物流单号
- CustInfo
- string
- false
- null
- 客户补充信息。ShipperCode为SF时，必填，对应收件人/寄件人手机号后四位；ShipperCode为JD时必填，对应京东的青龙配送编码，也叫商家编码，格式：数字＋字母＋数字，9位数字加一个字母，共10位，举例：001K123450；ShipperCode为其他快递时，不填
<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://kdniao.api.bdymkt.com/express/track";
ApiExplorerRequest request = new ApiExplorerRequest(HttpMethodName.POST, path);
request.setCredentials("您的 access key", "您的 secret key");
request.addHeaderParameter("Content-Type", "application/json;charset=UTF-8");
request.addQueryParameter("ShipperCode", "");
request.addQueryParameter("LogisticCode", "");
request.addQueryParameter("CustInfo", "");
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": {
"StateEx": "304",
"LogisticCode": "YT9420604605471",
"ShipperCode": "YTO",
"Traces": [
{
"Action": "1",
"AcceptStation": "【广东省汕头市龙湖区珠津公司】 已收件 取件人: 纪帆 (13642229527)",
"AcceptTime": "2020-12-26 23:24:27",
"Location": "汕头市"
},
{
"Action": "2",
"AcceptStation": "【广东省汕头市龙湖区珠津】 已发出 下一站 【揭阳转运中心公司】",
"AcceptTime": "2020-12-26 23:54:58",
"Location": "汕头市"
},
{
"Action": "2",
"AcceptStation": "【揭阳转运中心公司】 已收入",
"AcceptTime": "2020-12-27 01:49:08",
"Location": "揭阳市"
},
{
"Action": "2",
"AcceptStation": "【揭阳转运中心】 已发出 下一站 【深圳转运中心公司】",
"AcceptTime": "2020-12-27 01:50:47",
"Location": "揭阳市"
},
{
"Action": "2",
"AcceptStation": "【深圳转运中心公司】 已收入",
"AcceptTime": "2020-12-27 10:08:33",
"Location": "深圳市"
},
{
"Action": "2",
"AcceptStation": "【深圳转运中心】 已发出 下一站 【广东省深圳市福田区福瑞公司】",
"AcceptTime": "2020-12-27 10:18:16",
"Location": "深圳市"
},
{
"Action": "2",
"AcceptStation": "【广东省深圳市福田区福瑞公司】 已收入",
"AcceptTime": "2020-12-27 13:12:38",
"Location": "深圳市"
},
{
"Action": "202",
"AcceptStation": "【广东省深圳市福田区福瑞公司】 派件中 派件人: 陈杨 电话 15807551548 ",
"AcceptTime": "2020-12-27 13:21:07",
"Location": "深圳市"
},
{
"Action": "2",
"AcceptStation": "快件已到达新洲北村41栋104妈妈驿站妈妈驿站,联系电话18607552890",
"AcceptTime": "2020-12-27 15:10:14",
"Location": "深圳市"
},
{
"Action": "211",
"AcceptStation": "新洲北村41栋104妈妈驿站妈妈驿站已发出自提短信,请上门自提,联系电话18607552890",
"AcceptTime": "2020-12-27 15:10:15",
"Location": "深圳市"
},
{
"Action": "304",
"AcceptStation": "客户签收人: 他人签收,转入代办点 已签收 感谢使用圆通速递，期待再次为您服务 如有疑问请联系：15807551548",
"AcceptTime": "2020-12-30 19:22:31",
"Location": "深圳市"
}
],
"State": "3",
"Success": true,
"Location": "深圳市"
},
"type": "string"
}
失败返回示例 {"code":500,"message":"查询失败，无效的输入[【ShipperCode】物流公司编号不正确或物流渠道升级中，暂不支持查询，请下载快递鸟支持的快递公司编码列表核实后传值].需要帮助请稍后重试或者请联系业务员或官方客服: 400-9633-321。"}
错误码定义 - code
- message
- status
- 描述
- 200
- API调用成功
- 200
- 表示api调用成功有效请求
- 500
- API调用失败
- 500
- 详情请联系业务员或官方客服: 400-9633-321
