产品详情
API参数 轨迹跟踪查询支持的列表 调用地址: http,https://showapiexp.api.bdymkt.com/expTrack 请求方式: POST 支持格式: application/json;charset=UTF-8 调用工具: 去调试 请求参数（Headers） 请求参数（Query）
- 名称
- 类型
- 是否必须
- 示例值
- 描述
- com
- string
- true
- zhongtong
- 快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息 如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号 【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
- nu
- string
- true
- 75312165465979
- 快递单号
- senderPhone
- string
- false
- null
- 寄件人手机号后四位【手机号后四位填一个就行，多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
- receiverPhone
- string
- false
- null
- 收件人手机号后四位【手机号后四位填一个就行，多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
<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://gwgp-pt7hznkstln.n.bdcloudapi.com/expTrack";
ApiExplorerRequest request = new ApiExplorerRequest(HttpMethodName.POST, path);
request.setCredentials("您的 access key", "您的 secret key");
request.addHeaderParameter("Content-Type", "application/json;charset=UTF-8");
request.addQueryParameter("com", "");
request.addQueryParameter("nu", "");
request.addQueryParameter("senderPhone", "");
request.addQueryParameter("receiverPhone", "");
ApiExplorerClient client = new ApiExplorerClient(new AppSigner());
try {
ApiExplorerResponse response = client.sendRequest(request);
// 返回结果格式为Json字符串
System.out.println(response.getResult());
} catch (Exception e) {
e.printStackTrace();
}
}
}
点击复制代码
正常返回示例 {
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "5ffc81a7f9424a72939f68b19662e707",
"showapi_res_body": {
"upgrade_info": "尊敬的快递用户朋友：近期顺丰渠道调整，稳定的渠道需要您输入收（寄）件人的手机尾号4位，其字段名为：receiverPhone（或senderPhone）,详细接口文档位于 https://www.showapi.com/apiGateway/view?apiCode=64 ，为不影响您的业务，请尽快添加输入字段，感谢您的支持与理解。",
"update": 1574851415625,
"logo": "http://app2.showapi.com/img/expImg/zto.jpg",
"updateStr": "2019-11-27 18:43:35",
"dataSize": 11,
"status": 4,
"tel": "95311",
"showapi_fee_code": 0,
"expSpellName": "zhongtong",
"data": [
{
"time": "2019-11-16 21:33:56",
"context": "【九江市】 快件已在 【九江城西港】 签收, 签收人: 速递易, 如有疑问请电联:15779254414 / 13687028760, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】"
},
{
"time": "2019-11-16 07:31:24",
"context": "【九江市】 【九江城西港】 的城西港（15779254414） 正在第1次派件, 请保持电话畅通,并耐心等待（95720为中通快递员外呼专属号码，请放心接听）"
},
{
"time": "2019-11-16 07:31:23",
"context": "【九江市】 快件已经到达 【九江城西港】"
},
{
"time": "2019-11-15 19:06:30",
"context": "【九江市】 快件离开 【九江】 已发往 【九江城西港】"
},
{
"time": "2019-11-15 19:06:18",
"context": "【九江市】 快件已经到达 【九江】"
},
{
"time": "2019-11-15 10:45:21",
"context": "【南昌市】 快件离开 【南昌中转部】 已发往 【九江】"
},
{
"time": "2019-11-15 08:02:44",
"context": "【南昌市】 快件已经到达 【南昌中转部】"
},
{
"time": "2019-11-13 15:19:48",
"context": "【石家庄市】 快件离开 【石家庄】 已发往 【南昌中转部】"
},
{
"time": "2019-11-13 14:22:09",
"context": "【石家庄市】 快件已经到达 【石家庄】"
},
{
"time": "2019-11-13 14:08:31",
"context": "【石家庄市】 快件离开 【石家庄市场部】 已发往 【石家庄】"
},
{
"time": "2019-11-13 10:27:33",
"context": "【石家庄市】 【石家庄市场部】（0311-86891089、0311-68026565） 的 付保文四组（031186891089） 已揽收"
}
],
"msg": "查询成功",
"mailNo": "75312165465979",
"queryTimes": 1,
"ret_code": 0,
"flag": true,
"expTextName": "中通快递",
"possibleExpList": [
{
"simpleName": "zhongtong",
"expName": "中通快递"
}
],
"checkPhone": ""
}
}
失败返回示例 {
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "7349a6c8e46a43fcb7532de2de1c4f36",
"showapi_res_body": {
"mailNo": "7531216546",
"update": 1575255154122,
"upgrade_info": "尊敬的快递用户朋友：近期顺丰渠道调整，稳定的渠道需要您输入收（寄）件人的手机尾号4位，其字段名为：receiverPhone（或senderPhone）,详细接口文档位于 https://www.showapi.com/apiGateway/view?apiCode=64 ，为不影响您的业务，请尽快添加输入字段，感谢您的支持与理解。",
"queryTimes": 1,
"updateStr": "2019-12-02 10:52:34",
"ret_code": -1,
"flag": false,
"dataSize": 0,
"status": -1,
"tel": "",
"data": [],
"expSpellName": "zhongtong",
"showapi_fee_code": -1,
"expTextName": "",
"possibleExpList": [],
"msg": "单号不存在!"
}
}
错误码定义
