前期准备工作
去快递鸟官网免费注册一个账号,免费获得一个ApiKey(接口权限验证需要),完成实名认证流程,订购一个免费或付费套餐(也可找快递鸟工作人员免费申请付费的接口测试联调)
注:登录快递鸟用户管理后台后获得用户ID和APIKey对应各Demo中的EBusinessID、AppKey。
GitHub源码下载后运行替换ID和Key
README
nodejs调用代码
const axios = require('axios')const md5Hex = require('md5-hex');const querystring = require('querystring')const URL = 'http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx'const KEY = '06920cf9-2f55-49b1-b209-4afaceed36ee';//APP KEY,请向快递鸟申请const REQUEST_TYPE = '8001';//请求接口指令(8001查询)const BUSINESS_ID = 'xxxx' //更换用户idaxios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';const params = { ShipperCode:'SF', LogisticCode:'SF1040595620412', CustomerName:'5690'}const sign = Buffer.from(md5Hex(JSON.stringify(params)+KEY)).toString('base64')async function main(){ const reqParams = { RequestType:REQUEST_TYPE, EBusinessID:BUSINESS_ID, DataSign:sign, RequestData:JSON.stringify(params), DataType:2 } const res = await axios.post(URL,querystring.stringify(reqParams)) console.log(res.data) return res}main()
对接中的其他说明
1、物流查询(免费版)会员套餐为免费版,有效期1年结束后,如在近3个月内有数据交互系统会自动免费续期;
2、即时查询(RequestType:1002/8001) 日查询次数<=3000次对接即时查询接口
3、请求接口之前需要先实名认证,开通相关会员服务,否则会请求失败并返回提示“未申请开通接口”;
4、接口开发可以下载“当前项目”更改KEY密钥;
5、物流跟踪(RequestType:1008/8008) 日查询次数>3000次对接物流跟踪接口
6、测试订阅接口,对照技术文档正确返回代表订阅接口对接成功,详情可见技术文档。
7、开发推送接口,无demo提供,推送时会推送requestType、requestData和DataSign三个参数,您开发一个推送接口接收这三个参数就行,成功接收后需要在5S内给快递鸟返回成功收数据的报文,否则超时。RequestData中包含应用级参数,即物流轨迹(详情看技术文档);
8、订阅接口、推送接口分别测试成功后,可使用正式地址进行订阅真实的快递单号,快递鸟一般会在2-12小时内推送物流信息至您已经配置好的回调地址上;
快递鸟快递单号查询接口,企业级快递物流下单接口【快递鸟API官网】