一、接口介绍
支持国内外1500+快递物流公司的物流跟踪服务,包括顺丰、圆通、申通、中通、韵达等主流快递公司。同时,支持单号识别快递物流公司、按次与按单计费、物流轨迹返回等功能,以满足企业对快递物流查询多维度的需求。
二、使用案例截图
三、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.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.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.9具体流程说明
3.3.9.1功能说明
用户提交快递单号及快递公司编码到易源,易源在信息有更新时,将单号物流轨迹POST推送至用户指定的callBackUrl。在物流未签收前,易源会进行多次推送操作。
3.3.9.2使用场景示例图如下
四、工具
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.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.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.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点整更新一次