快递鸟接口调试平台使用指南

《快递鸟接口调试平台使用指南》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、快递鸟调试平台使用指南快递鸟接口调试平台使用指南快递鸟调试平台使用指南版本日期版本说明作者2016-9-271.0新建调试平台使用说明文档胡蕾蕾2017-2-222.0文档整体更新胡蕾蕾快递鸟调试平台使用指南目录1、前言42、使用指南42.1登陆调试平台42.2即时查询62.3订阅推送接口72.3.1订阅接口82.3.2推送接口102.3.3推送地址修改152.4电子面单172.5单号识别193、技术支持22快递鸟调试平台使用指南1、前言快递鸟API旨在为电商、电商平台、物流工具、仓储系统等系统提供专业、稳定、优质的物流服务

2、，为不同的用户量身定做了专业的API接口服务，供不同的用户各取所需。接口申请：快递鸟官网注册账号后，在后台获取私有接口秘钥，对接接口并使用。为了方便用户接入快递鸟接口，我们提供了调试平台供用户使用。用户可以通过调试平台进行接口测试与校验，以及推送地址自助配置。本文档就快递鸟调试平台的使用进行详细讲解。2、使用指南2.1登陆调试平台1、使用快递鸟账户登陆官网：快递鸟调试平台使用指南2、点击左侧菜单栏【调试平台】选项1、进入调试平台。调试平台目前包含：即时查询、订阅推送、电子面单、单号识别等接口调试功能，下面分接口进行使用详解。

3、快递鸟调试平台使用指南2.2即时查询1、点击左侧【即时查询】菜单栏进入即时查询调试界面。2、在ShipperCode和LogisticCode中填快递公司编码和快递单号，点击【生成】按钮后会自动在【系统级参数报文】和【应用级参数报文(RequestData)】的文本框中生成请求报文。用户可将调试平台上生成的报文与自己程序生成的报文进行比较，校验程序生成报文是否正确。快递鸟调试平台使用指南1、点击【调用】按钮，提交请求。【应用级参数报文】文本框中显示的就是快递鸟返回的轨迹信息。2.3订阅推送接口点击菜单栏【订阅推送】选项进入订

4、阅推送接口调试界面。该页面包括【订阅】、【推送】两个tab页。快递鸟调试平台使用指南2.3.1订阅接口1、选择【订阅】进行订阅接口调试。订阅接口中“ShipperCode”（快递公司编码）和“LogisticCode”（快递单号）是必填的。用户可以根据自己实际填写请求参数。2、点击【生成】按钮，【系统级参数报文】和【应用级参数报文快递鸟调试平台使用指南(RequestData)】相应文本框会自动生成请求报文。用户可以将自己生成的请求报文与调试平台生成的请求报文进行比较，校验自己程序处理是否正确。3、点击【调用】按钮请求订阅接

5、口后【应用级参数报文】下文本框会显示快递鸟返回的信息。Success为true代表订阅接口请求成功。2.3.2推送接口快递鸟调试平台使用指南1、选择【推送】进入推送接口调试界面。2、在【输入接收快递鸟推送的地址】文本框中填入回调地址。3、选择测试请求参数，点击【生成】按钮自动生成请求报文。快递鸟调试平台使用指南4、点击【调用】按钮调用你的推送地址。【应用级参数报文】中显示的就是你接口返回的值。*注：必须按照快递鸟要求的规范进行返回，否则回调地址验证将会失败，不能进行回调地址配置。请按照如图规范进行返回，参数名区分大小写常见错

6、误分析：若点击【调用】后，显示“未接收到回调处理结果”，快递鸟调试平台使用指南有以下两种原因：（1）、在你的推送接口中未设置返回参数。（2）、推送接口返回结果格式有问题，导致快递鸟解析失败。要求返回的是一个json字符串对象。处理方法：按照快递鸟规范返回以下四个参数：参数名称类型必须要求说明EBusinessIDStringR用户IDUpdateTimeStringR时间SuccessStringR成功与否ReasonStringO失败原因Json返回示例：{"EBusinessID":"1109259",快递鸟调试平台使用

7、指南"UpdateTime":"2015-03-1116:26:11","Success":true,"Reason":""}5、用户确认自己推送地址接收和返回都成功后，可以进行回调地址自助配置。点击【配置】按钮进行配置。6、在弹出的界面中输入手机号、获取的验证码、已测试通过的回调地址。快递鸟调试平台使用指南7、点击【保存】按钮。显示如图提示则表示回调地址已经配置成功。（*配置成功即已开通推送权限，用户在正式环境下订阅（http://api.kdniao.cc/api/dist）就会收到快递鸟推送的轨迹）常见错误分析；若在配

8、置回调地址时显示如下警告，请确认您的回调接口返回参数是否符合快递鸟规范。2.3.3推送地址修改请至此页面修改推送地址：http://www.kdniao.com/UserCenter/Dev/Index.aspx1、若之前有配置过推送地址，会在红框处进行显示。快递鸟调试平台使用指南2、点击