基于JAVA快递查询API接口调用代码示例.docx

基于java的快递查询API接口调用代码示例1、应用场景（1）电商网站用户打开“我的订单”时调用此API显示物流信息详情。（2）电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题。（3）每日调用次数限制不超过3000次，如超过该限制，请对接订阅推送API。2、是否需要授权要Free申请服务3、接口描述/说明（1）查询接口支持按照运单号查询(单个查询)。（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码（3）返回的物流跟踪信息按照发生的时间升序排列。（4）接口指令1002。（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)：application/x-www-form-urlencoded;charset=utf-8。（6）请求系统级参数说明：参数名称类型说明必须要求RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。REBusinessIDString商户ID，请在我的服务页面查看。RRequestTypeString请求指令类型：1002RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。RDataTypeString请求、返回数据类型：2-json；O备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。（7）接口地址：API ID：点击申请API Key：点击申请API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx4、接口参数（1）请求内容字段定义参数类型说明必须要求OrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流单号R（3）返回参数定义参数名称类型说明必须要求EBusinessIDString用户IDROrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流运单号RSuccessBool成功与否RReasonString失败原因OStateString物流状态：2-在途中,3-签收,4-问题件RTracesTraceAcceptTimeString时间RAcceptStationString描述RRemarkString备注O5、示例（1）请求示例JSON格式show sourceview sourceprint?1{??? 2????OrderCode: ,??? 3????ShipperCode: SF,??? 4????LogisticCode: 1186508880185}（2）返回示例JSON格式show sourceview sourceprint?01没有物流轨迹的02{03????EBusinessID: 1109259,04????Traces: [],05????OrderCode: ,06????ShipperCode: SF,07????LogisticCode: 118461988807,08????Success: false,09????Reason: null10}11有物流轨迹的12{13????EBusinessID: 1109259,14????OrderCode: ,15????ShipperCode: SF,16????LogisticCode: 118461988807,17????Success: true,18????State: 3,19????Reason: null,20????Traces: [21????????{22????????????AcceptTime: 2014/06/25 08:05:37,23????????????AcceptStation: 正在派件..(派件人:邓裕富,电话[深圳 市],24????????????Remark: null25????????},26????????{27????????????AcceptTime: 2014/06/25 04:01:28,28????????????AcceptStation: 快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市],29????????????Remark: null30????????},31????????{32??