基于JAVA的快递查询API接口调用代码示例选编.docxVIP

基于java的快递查询API接口调用代码示例 1、应用场景 （1）电商网站用户打开“我的订单”时调用此API显示物流信息详情。（2）电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题。（3）每日调用次数限制不超过3000次，如超过该限制，请对接 HYPERLINK /api-subscribe 订阅推送API。 2、是否需要授权 要 HYPERLINK /reg Free申请服务 3、接口描述/说明 （1）查询接口支持按照运单号查询(单个查询)。（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。如：EMS物流单号应选择快递公司编码（EMS） HYPERLINK /file/ExpressCode.xls \t _blank 查看快递公司编码（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，请在 HYPERLINK /MyService.aspx \t _blank 我的服务页面查看。RRequestTypeString请求指令类型：1002RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。RDataTypeString请求、返回数据类型：2-json；O备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。（7）接口地址：API ID： HYPERLINK /reg \t _blank 点击申请API Key： HYPERLINK /reg \t _blank 点击申请API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx 4、接口参数 （1）请求内容字段定义 参数类型说明必须要求OrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流单号R（3）返回参数定义 参数名称类型说明必须要求EBusinessIDString用户IDROrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流运单号RSuccessBool成功与否RReasonString失败原因OStateString物流状态：2-在途中,3-签收,4-问题件RTracesTraceAcceptTimeString时间RAcceptStationString描述RRemarkString备注O5、示例 （1）请求示例JSON格式  HYPERLINK /api-track \l expandSource \o show source show source HYPERLINK /api-track \l viewSource \o view source view source  HYPERLINK /api-track \l printSource \o print print HYPERLINK /api-track \l about \o ? ? 1{??? 2????OrderCode: ,???  3????ShipperCode: SF,??? 4????LogisticCode: 118650888018 5}（2）返回示例JSON格式  HYPERLINK /api-track \l expandSource \o show source show source HYPERLINK /api-track \l viewSource \o view source view source  HYPERLINK /api-track \l pr