全国快递查询接口，快递，全球快递，配送，物流管理，物流数据，电子商务

一、接口介绍

支持国内外1500+快递物流公司的物流跟踪服务，包括顺丰、圆通、申通、中通、韵达等主流快递公司。同时，支持单号识别快递物流公司、按次与按单计费、物流轨迹返回等功能，以满足企业对快递物流查询多维度的需求。

二、使用案例截图

应用场景

电子商务平台：您的API可以集成到电子商务平台中，使买家能够实时追踪他们的快递物流信息，提高用户体验和购物信任感。
物流服务提供商：物流公司和快递服务提供商可以使用您的API来提供物流跟踪功能，使他们的客户能够方便地查询包裹的实时位置和状态。
在线零售商：在线零售商可以将您的API集成到他们的网站或应用程序中，让顾客能够准确地了解他们的订单在配送过程中的状态，提供更好的客户服务。
物流管理系统：物流管理系统可以使用您的API来实时监控和跟踪货物的运输情况，提高物流运作的效率和可视化。
物流数据分析：物流数据分析公司可以使用您的API来获取大量的物流数据，进行数据挖掘和分析，以改进物流运营和制定更好的物流策略。
餐饮外卖：可以使用其跟踪外卖订单的状态和位置，以便餐厅和消费者可以了解外卖送达的时间。
物流配送：可以使用其来规划最优路线和派送顺序，以便物流配送公司可以更高效地完成配送任务。
个人物品追踪：可以使用其来跟踪个人包裹的状态和位置，以便个人用户可以了解他们的包裹送达的时间。

三、API文档

3.1按次计费查询物流

3.1.1接入点说明：

使用快递单号实时查询物流信息轨迹，包括收件、运输、配送情况等。本接入点为阻塞式的同步调用。

3.1.2接口地址：

http[s]://route.showapi.com/2650-3?showapi_appid=替换自己的值&showapi_sign=替换自己的值

3.1.3更新频率:

10分钟

3.1.4返回格式:

json

3.1.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/2650-8","showapi_appid","showapi_sign")

.addTextPara("com","zhongtong")

.addTextPara("nu","75450632975559")

.addTextPara("phone","")

.post();

System.out.println(res);

3.1.8具体流程说明

本接口使用快递单号及快递公司编码二要素，查询单号物流轨迹。

使用HTTP的get或post请求，以普通表单提交方式，编码：Content-Type=application/x-www-form-urlencoded发送数据，阻塞式调用。其时序图如下3.1.8-1所示：

图3.1.8-1时序图

curl调用时的url如下所示：

curl "http://route.showapi.com/2650-3?showapi_appid=替换自己的值&com=yuantong&nu=YT4620020577123&phone=&showapi_sign=替换自己的值"

调用超时时间为30秒。

3.1.9使用场景示例图如下

用户在商城后台界面，查询购买的货品物流信息（类似于淘宝用户在后台查看快递单物流）。整体流程如下所示：

3.1.9.1同步查询

3.1.9.2异步查询

异步查询推送说明

推送方式：POST；

推送类型：Content-Type = application/x-www-form-urlencoded;charset=utf-8；

推送格式：

{"result":"{\"queryTimes\":1,\"upgrade_info\":\"\",\"fee_num\":0,\"status\":4,\"expSpellName\":\"zhongtong\",\"msg\":\"查询成功\",\"updateStr\":\"2021-07-07 11:06:56\",\"possibleExpList\":[],\"flag\":true,\"tel\":\"95311\",\"ret_code\":0,\"logo\":\"http://static.showapi.com/app2/img/expImg/zto.jpg\",\"expTextName\":\"中通快递\",\"data\":[{\"context\":\"【金华市】快件离开【义乌新科】已发往【昆明中转】\",\"time\":\"2021-03-29 17:09:49\"},{\"context\":\"【金华市】【义乌新科】（0579-82402509、0579-85960530）的义乌新科自动分拣（18966053802）已揽收\",\"time\":\"2021-03-29 17:09:41\"}],\"mailNo\":\"75450632975559\",\"dataSize\":11,\"update\":1625627216749}"}

消息确认：用户服务器收到易源请求后，需要回复一个消息以确认。

此消息需要同时满足以下条件：

- http的返回状态为必须为200；

- http的返回体是：{"success":true} 。

如果不满足上面2个条件则认为失败。失败时易源会重复推送5次，间隔时间分别是2,4,8,16,32分钟。

3.1.10快递状态码

3.2按单计费查询物流

3.2.1接入点说明：

使用快递单号实时查询物流信息轨迹，包括收件、运输、配送情况等。本接入点为阻塞式的同步调用。

更多帮助请查看 https://www.showapi.com/book/view/3157/13

30天内1个快递单多次查询只扣1次费。

3.2.2接口地址：

http[s]://route.showapi.com/2650-8?showapi_appid=替换自己的值&showapi_sign=替换自己的值

3.2.3更新频率:

10分钟

3.2.4返回格式:

json

3.2.5请求参数

3.2.6返回参数

3.2.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-34","showapi_appid","showapi_sign")

.addTextPara("com","zhongtong")

.addTextPara("nu","75450632975559")

.addTextPara("phone","")

.post();

System.out.println(res);

3.2.8具体流程说明

3.2.8.1介绍

用户使用快递单号及快递公司编码，可同步查询单号物流轨迹。

使用HTTP的get或post请求，以普通表单提交方式，编码：Content-Type=application/x-www-form-urlencoded发送数据，同步阻塞式调用。其流程图如下3.2.8.1-1所示：

图3.2.8.1-1流程图

为什么要用按单查询？

1单在30天内只计费一次，可任意查询。概念清晰，性价比高，便于用户管理成本。

3.2.8.2流程步骤说明

图3.2.8.1-1流程图中第1步

curl调用如下所示：

curl "http://route.showapi.com/2650/8?showapi_appid=替换己的值&com=zhongtong&nu=75312165465979&phone=&showapi_sign=替换自己的值"

具体参数是：

参数名	描述
com	快递公司编码，使用【工具】查询快递公司列表接口获取。
nu	快递单号。
phone	可选。只对于顺丰单号查询有效。是收件人或发件人的手机号码后4位。如果是顺丰单号，请务必传递本参数。

调用超时时间为30秒。

3.2.8.3按单计费说明

3.2.9使用场景示例图如下

3.3批量提交订单订阅

3.3.1接入点说明:

批量提交快递单号（每次最多提交100单），如果此单物流轨迹有更新，则易源会将物流结果推送至用户定义的回调URL（此URL由"【工具】设置推送回调地址"接入点来设定），直至签收结束。

由于是异步操作，易源加入了多次重试、容错切换等机制，可以大大避免快递查询高峰带来的业务抖动，提高查询成功率。

更多帮助请查看 https://www.showapi.com/book/view/3157/14

推送时，您的服务器需要返回：

1.http返回状态码=200

2.返回体为{"success":true} 或 success 确认收信成功。

3.3.2接口地址:

http[s]://route.showapi.com/64-23?showapi_appid=替换自己的值&showapi_sign=替换自己的值

3.3.3返回格式:

json

3.3.4更新频率:

每个快递被揽收完成，录入相应的快递公司后，官网即可查询到物流信息

3.3.5返回格式:

json

3.3.6请求参数

3.3.7返回参数

3.3.8请求代码示例

以下是JAVA代码示例:

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-23","showapi_appid","showapi_sign")

.addTextPara("com_nu","")

.post();

System.out.println(res);

3.3.9具体流程说明

3.3.9.1功能说明

用户提交快递单号及快递公司编码到易源，易源在信息有更新时，将单号物流轨迹POST推送至用户指定的callBackUrl。在物流未签收前，易源会进行多次推送操作。

3.3.9.2使用场景示例图如下

3.3.9.3规范

1、使用步骤

首先设置回调地址。
提交需要推送的快递单号。
异步等待易源post信息到您的callbackUrl。

2、提交规范

使用HTTP的get或post请求，以普通表单提交方式，编码：Content-Type=application/x-www-form-urlencoded发送数据，阻塞式调用。

3、推送规则

（1）每天定时推送，推送时间段为：每天的08:00—22:00，平均每两个小时为一次，每天预计8次。

（2）物流信息有增量变化时才会推送。

（3）物流信息无变化，超过3天，将会推送无变化的信息

4、关键参数com_nu说明

com_nu是一个list结构，其中的每一个object有4个属性：

[{

"com": "shunfeng",

"nu": "299801844590",

"phone": "1234",

"outCode": "任意串，长度小于200字符"

{

"com": "shunfeng",

"nu": "299801844592",

"phone": "",

"outCode": "thisismyoutcode"

{

"com": "shunfeng",

"nu": "299801844593",

"phone": "",

"outCode": "this is my json string"

}

]

其中每个字段的含义是：

参数名	描述
com	快递公司编码，点此查看列表，也可以使用【工具】查询快递公司列表接口获取。
nu	快递单号。
phone	可选。只对于顺丰单号查询有效。是收件人或发件人的手机号码后4位。如果是顺丰单号，请务必传递本参数。
outCode	比如您在提交查询时，传入outCode=myOrderId123456,那么易源在推送结果到回调URL时，会带上outCode=myOrderId123456给您，便于您做单号对应。 outCode是一个< 200长度的串（也可以是json的string格式），易源回推时将原封返回。

易源在回推单号物流时，会将您提交的outCode值一并提交过来，便于您标识单号身份。

3.3.10注意事项

回复格式

用户服务器收到易源请求后，需要回复一个消息以确认。此消息的2个要求是：

条件名称	描述
http返回状态码	等于200
http返回体	{"success":true} 或 success

如果不满足上面2个条件（且的关系）则认为失败。失败时易源会重复推送5次，间隔时间分别是2,4,8,16,32分钟。

推送的实例

#http头

host:129.211.129.137:7243 //易源推送服务器地址，会改变

content-type:application/x-www-form-urlencoded;charset=utf-8

content-length:697

user-agent:lua-resty-http/0.12 (Lua) ngx_lua/10013

#http body

result=%7B%22queryTimes%22%3A1%2C%22upgrade_info%22%3A%22%22%2C%22fee_num%22%3A0%2C%22status%22%3A2%2C%22expSpellName%22%3A%22huitong%22%2C%22msg%22%3A%22%E6%9F%A5%E8%AF%A2%E6%88%90%E5%8A%9F%22%2C%22updateStr%22%3A%222020-11-02%2010%3A47%3A37%22%2C%22outCode%22%3A%22%22%2C%22flag%22%3Atrue%2C%22tel%22%3A%2295320%22%2C%22ret_code%22%3A0%2C%22logo%22%3A%22http%3A%2F%2Fstatic.showapi.com%2Fapp2%2Fimg%2FexpImg%2Fht.jpg%22%2C%22expTextName%22%3A%22%E7%99%BE%E4%B8%96%E5%BF%AB%E9%80%92(%E5%8E%9F%E6%B1%87%E9%80%9A)%22%2C%22data%22%3A%5B%7B%22context%22%3A%22%E3%80%90%E4%B9%89%E4%B9%8C%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%EF%BC%8C%E6%AD%A3%E5%8F%91%E5%BE%80%E3%80%90%E5%A4%A9%E6%B4%A5%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2022%3A57%3A19%22%7D%2C%7B%22context%22%3A%22%E5%88%B0%E3%80%90%E4%B9%89%E4%B9%8C%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2022%3A55%3A13%22%7D%2C%7B%22context%22%3A%22%E3%80%90%E5%85%B0%E6%BA%AA%E3%80%91%EF%BC%8C%E6%AD%A3%E5%8F%91%E5%BE%80%E3%80%90%E9%87%91%E5%8D%8E%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2017%3A56%3A19%22%7D%2C%7B%22context%22%3A%22%E5%88%B0%E3%80%90%E5%85%B0%E6%BA%AA%E9%9B%86%E8%B4%A7%E7%82%B9%E3%80%91%22%2C%22time%22%3A%222020-11-01%2017%3A42%3A28%22%7D%2C%7B%22context%22%3A%22%E3%80%90%E4%B9%89%E4%B9%8C%E9%BE%9A%E5%A4%A7%E5%A1%98%E5%88%86%E9%83%A8-%E4%BC%98%E8%B4%A8%E5%AE%A2%E6%88%B7%E3%80%91%EF%BC%8C%E3%80%90%E5%BC%A0%E6%9F%B3%E5%A9%B7%2F15658902667%E3%80%91%E5%B7%B2%E6%8F%BD%E6%94%B6%22%2C%22time%22%3A%222020-11-01%2017%3A08%3A49%22%7D%5D%2C%22mailNo%22%3A%22557030343293696%22%2C%22possibleExpList%22%3A%5B%5D%2C%22dataSize%22%3A5%2C%22update%22%3A1604285257608%7D

四、工具

4.1查询快递公司列表

4.1.1接入点说明：

可查询易源支持的1500+家快递公司列表。

4.1.2接口地址：

http[s]://route.showapi.com/64-20?showapi_appid=替换自己的值&showapi_sign=替换自己的值

4.1.3返回格式:

Json

4.1.4更新频率:

新增一个快递时，将会更新一次

4.1.5请求参数

4.1.6返回参数

4.1.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-20","showapi_appid","showapi_sign")

.addTextPara("expName","风")

.addTextPara("maxSize","")

.addTextPara("page","")

.post();

System.out.println(res);

4.1.8返回示例

{

"showapi_res_error": "",

"showapi_res_code": 0,

"showapi_res_id": "60ebb1770de3761e66738645",

"showapi_res_body": {

"ret_code": 0,

"express_list": [

{

"img_url": "http://static.showapi.com/app2/img/expImg/shunfeng.jpg",

"phone": "95338",

"exp_name": "顺丰速运",

"com": "shunfeng",

"url": "http://www.sf-express.com",

"note": ""

}

"msg": "查询成功!"

}

4.2单号查快递公司

4.2.1接入点说明：

通过单号推测其所属的快递公司列表,以可能性大小逆序排序

4.2.2接口地址：

http[s]://route.showapi.com/64-21?showapi_appid=替换自己的值&showapi_sign=替换自己的值

4.2.3返回格式:

Json

4.2.4更新频率:

立即返回结果数据未做缓存，返回的是最新实时数据

4.2.5请求参数

4.2.6返回参数

4.2.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-21","showapi_appid","showapi_sign")

.addTextPara("nu","SF1163287169821")

.addTextPara("addOther","1")

.post();

System.out.println(res);

4.2.8返回示例

{

"showapi_res_code": 0,

"showapi_res_error": "",

"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",

"showapi_res_body": {

"ret_code": 0,

"data": [

{

"simpleName": "zhongtong",

"expName": "中通快递"

{

"simpleName": "shunfeng",

"expName": "顺丰速运"

}

"msg": "操作成功!"

}

4.3设置推送回调地址

4.3.1接入点说明：

快递单有更新时，易源主动将全量物流轨迹以POST请求到此URL。本接入点负责设置/修改此URL

4.3.2接口地址：

http[s]://route.showapi.com/64-22?showapi_appid=替换自己的值&showapi_sign=替换自己的值

4.3.3返回格式:

Json

4.3.4更新频率:

立即返回结果数据未做缓存，返回的是最新实时数据

4.3.5请求参数

4.3.6返回参数

4.3.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-22","showapi_appid","showapi_sign")

.addTextPara("callBackUrl","")

.post();

System.out.println(res);

4.3.8返回示例

{

"showapi_res_error": "",

"showapi_res_id": "f34ae19c68b447d48ebc7ed0b67107a1",

"showapi_res_code": 0,

"showapi_res_body": {

"ret_code": 0,

"updateTime": "1561711425361",

"showapi_fee_code": 0,

"callback_method": "get",

"callback_url": "http://xxxxxx.com/ForTest/dodo",

"updateTimeStr": "2019-06-28 16:43:45.045",

"msg": "成功"

}

4.4查询快递网点

4.4.1接入点说明：

通过网点名称、网点地址、联系电话等查询网点信息

4.4.2接口地址：

http[s]://route.showapi.com/64-36?showapi_appid=替换自己的值&showapi_sign=替换自己的值

4.4.3返回格式:

Json

4.4.4更新频率:

每年12月1日凌晨1点整更新一次

4.4.5请求参数

4.4.6返回参数

4.4.7请求代码示例

以下是JAVA代码示例:

//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java

//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp

String res=new ShowApiRequest("http://route.showapi.com/64-36","showapi_appid","showapi_sign")

.addTextPara("siteName","小西门")

.addTextPara("addr","")

.post();

System.out.println(res);

4.4.8返回示例

{

"showapi_res_error": "",

"showapi_res_code": 0,

"showapi_res_id": "608227268d57ba3e701d0ca5",

"showapi_res_body": {

"ret_code": 0,

"flag": true,

"siteList": [

{

"com": "yunda",

"remark": "",

"tel": "15287171701",

"lng": "102.68115",

"city": "昆明市",

"address": "云南省昆明市西山区金碧街道西园路268号",

"serviceTime": "",

"name": "云南昆明五华区小西门公司西园路寄存点分部",

"province": "云南省",

"expTextName": "韵达速递",

"linkman": "徐毅",

"district": "西山区",

"lat": "25.04222"

{

"com": "shunfeng",

"address": "新疆维吾尔自治区乌鲁木齐市天山区新华南路街道河滩南路288号",

"serviceTime": "09:00-19:00",

"tel": "0991-8890095",

"name": "小西门速运营业点",

"province": "新疆维吾尔自治区",

"expTextName": "顺丰速运",

"lng": "87.6072259779655",

"linkman": "张炜",

"district": "天山区",

"lat": "43.7962712434222",

"city": "乌鲁木齐市"

{

"com": "yunda",

"remark": "",

"tel": "18167977461",

"lng": "87.61755",

"city": "乌鲁木齐市",

"address": "新疆维吾尔自治区乌鲁木齐市天山区解放南路街道人民路育才巷32号",

"serviceTime": "",

"name": "新疆主城公司乌鲁木齐小西门服务部",

"province": "新疆维吾尔自治区",

"expTextName": "韵达速递",

"linkman": "裴明明",

"district": "天山区",

"lat": "43.79126"

}

]

}

五、数据加密传输

除了使用默认的HTTPS证书加密传输以外，还可以对输入输出字段做业务级的单独加密。

加密算法：AES/ECB/PKCS5Padding，AES结果全大写，使用base64编码。密钥由双方线下约定。
客户端对所有输入字段进行单独加密。
服务端输出加密字段showapi_res_encryption，它是一个base64串，解密后将其反序列化为json对象，对象字段与文档中的返回字段一致。

六、应用场景

电子商务平台：您的API可以集成到电子商务平台中，使买家能够实时追踪他们的快递物流信息，提高用户体验和购物信任感。
物流服务提供商：物流公司和快递服务提供商可以使用您的API来提供物流跟踪功能，使他们的客户能够方便地查询包裹的实时位置和状态。
在线零售商：在线零售商可以将您的API集成到他们的网站或应用程序中，让顾客能够准确地了解他们的订单在配送过程中的状态，提供更好的客户服务。
物流管理系统：物流管理系统可以使用您的API来实时监控和跟踪货物的运输情况，提高物流运作的效率和可视化。
物流数据分析：物流数据分析公司可以使用您的API来获取大量的物流数据，进行数据挖掘和分析，以改进物流运营和制定更好的物流策略。
餐饮外卖：可以使用其跟踪外卖订单的状态和位置，以便餐厅和消费者可以了解外卖送达的时间。
物流配送：可以使用其来规划最优路线和派送顺序，以便物流配送公司可以更高效地完成配送任务。
个人物品追踪：可以使用其来跟踪个人包裹的状态和位置，以便个人用户可以了解他们的包裹送达的时间。

七、附件

7.1按次及按单返回示例

{

"showapi_res_error": "",

"showapi_res_code": 0,

"showapi_res_id": "5ea916438d57baae126d08d7",

"showapi_res_body": {

"update": 1588071235436,

"upgrade_info": "",

"updateStr": "2020-04-28 18:53:55",

"logo": "http://app2.showapi.com/img/expImg/zto.jpg",

"dataSize": 11,

"status": 4,

"fee_num": 1,

"tel": "95311",

"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-68026565、0311-68026566）的付保文四组（031186891089）已揽收"

}

"expSpellName": "zhongtong",

"msg": "查询成功",

"mailNo": "75312165465979",

"queryTimes": 1,

"ret_code": 0,

"flag": true,

"expTextName": "中通快递",

"possibleExpList": []

}