前两天需要做一个快递查询的需求,由于也是第一次做,完全不懂,但是还是明白这必定是需要调用外部接口来实现,并且应该不是调用快递公司所给的接口,那样一家家对接很麻烦,于是便上网查询了能够提供快递查询接口的公司,国内主流的快递物流查询API接口服务商目前只有三家,分别是菜鸟、快递鸟、快递100,这三家都分别获得了融资,菜鸟是阿里投资的(http://newseed.pedaily.cn/data/invest/40084),为淘系(淘宝和天猫)服务。快递鸟是中银粤财、东方富海、启赋资本投资的(http://newseed.pedaily.cn/data/invest/41050),为非淘系(拼多多、蘑菇街、网易考拉等)服务。快递100是京东、国信弘盛投资的( https://zdb.pedaily.cn/inv/show12486 ),为京东、百度等服务。类似阿里云这类应用市场平台,入驻这类的平台的很多服务商都是用的快递鸟免费物流接口,快递鸟除快递查询API接口之外,还提供了其他的服务接口(快递鸟API接口-为电商提供最全面的物流api服务),也更加完善,如果想在将来对自己产品的物流模块全流程业务进行功能完善,个人推荐选择快递鸟,快递鸟是全球最大的第三方快递物流接口服务商, 目前已经集成了418家快递单号查询接口,31家电子面单接口。高实时、高稳定、高并发,支持快递单号自动识别。本人公司选择的是快递鸟(https://www.kdniao.com),所以就以快递鸟作为案例进行解说吧。
快递鸟第三方快递查询接口很好用,关键免费,使用的用户很多,有十几个千人技术QQ群为用户免费的技术支持接入服务,整个对接非常简单,到快递鸟网站免费注册申请KEY和ID,下载调用Demo,修改下参数对接后就可以实现快递查询了。
【注册快递鸟账号】快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册
注册完成后登入,进入到个人中心,这里需要进行一个实名认证,按公司产品的类型进行一个选择,展示页面如下图
认证完成后在我的产品服务中选择自己所需要的服务,当然对于初创型公司来说选择免费版就够了,等到业务做大时再选择其他产品服务
还有就是在个人中心中如下图所示,我们需要记住的是用户ID,和API key(不要泄露),这将是我们进行接口调用时需要用到的,
【调用接口文档】快递物流api接口文档下载_电子面单接口文档-快递鸟code接口文档
说完了上面的,接下来我们就开始调用API进行开发吧,打开首页中API文档,选择即时查询,我们可以看到它对改接口的介绍,我们来看看对于参数的说明,下图是在发送请求时所需的参数
下图是进行接口请求时需要用的参数,这里需要说明下,每个所提供接口的公司他们对物流公司的编码都不同,可以下载他们提供的编码文档进行查询(http://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx),避免出现错误,当然快递鸟也有提供根据物流单号查询智能查询快递公司以及编码,下面我会一起详细介绍
下图是请求成功后返回的数据
我们可以下载他们写好的分别是即时查询接口demo(快递鸟「即时查询DEMO」让对接更简单)和单号识别接口demo进行更改,这里就不打开demo了,我直接讲解我修改后的,并且也不讲解前端代码,大家只要根据文档来进行数据传输就可以了,后端代码这里建议大家将以下数据抽取出来单独建一个类,方便以后信息修改:
公共信息
/*快递鸟查询快递信息*/
controller层
@
由于即时查询接口demo和单号识别接口demo它们中的部分方法有所重复,故对它们重复的方法进行抽取,作为公共的方法:
公共方法类
public
service层
@
@
这里测试返回的数据大家可以参考API所提供的数据,形式就跟我们在支付宝上查询的物流信息一样,美化的话就需要靠前端了,这里就不给大家展示了。