基于PHP的韵达电子面单接口文档.docx

基于PHP的韵达电子面单接口文档1.接口类型说明1）接口支持的消息接收方式：HTTP POST2）请求方法的编码格式(utf-8)：application/x-www-form-urlencoded;charset=utf-83）API地址：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx4）接口提供：快递鸟5）快递编码：YD2.请求系统级参数参数名称类型说明必须要求RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。REBusinessIDString商户ID，请在我的服务页面查看。RRequestTypeString请求指令类型：1007RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。RDataTypeString请求、返回数据类型：只支持JSON格式O备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。3.对接示例1）JSON请求示例OrderCode:012657700387,ShipperCode:HTKY,PayType: 1,ExpType: 1,Cost: 1.0,OtherCost: 1.0,Sender: Company:LV,Name:Taylor,MobileProvinceName:上海,CityName:上海,ExpAreaName:青浦区,Address:明珠路73号,Receiver: Company:GCCUI,Name:Yann,MobileProvinceName:北京,CityName:北京,ExpAreaName:朝阳区,Address:三里屯街道雅秀大厦,Commodity: GoodsName:鞋子,Goodsquantity: 1,GoodsWeight: 1.0,AddService: Name:COD,Value:1020,Weight: 1.0,Quantity: 1,Volume: 0.0,Remark:小心轻放,IsReturnPrintTemplate:12）JSON返回示例失败：EBusinessID:1237100,ResultCode:105,Reason:订单号已存在，请勿重复操作，UniquerRequestNumber:5e66486b-8fbc-4131-b875-9b13d2ad1354成功：EBusinessID:1237100,Order: OrderCode:012657700387,ShipperCode:HTKY,LogisticCode:50002498503427,MarkDestination:京-朝阳(京-1),OriginCode:200000,OriginName:上海分拨中心,PackageCode:北京,PrintTemplate:此处省略打印模板HTML内容,EstimatedDeliveryTime:2016-03-06,Callback:调用时传入的Callback,Success:true,ResultCode:100,Reason:成功4.PHP对接源码?php/电商IDdefined(EBusinessID) or define(EBusinessID, 请申请/ServiceApply.aspx);/电商加密私钥，注意保管，不要泄漏defined(AppKey) or define(AppKey, 请申请/ServiceApply.aspx);/请求url，接口正式地址：http:/api.kdniao.cc/api/Eorderservicedefined(ReqURL) or define(ReqURL, http:/testapi.kdniao.cc:8081/api/Eorderservice);/调用获取物流轨迹/-/构造电子面单提交信息$eorder = ;$eorderShipperCode = YD;$eorderOrderCode = PM201604062341;$eorderPayType = 1;$eorderExpType = 1;$sender = ;$senderName = 李先生;$senderMobile =$senderProvinceName = 李先生;$senderCityName = 深圳市;$senderExpAreaName = 福田区;$senderAddress = 赛格广场5401AB;$receiver = ;$receiverName = 李先生;$receiverMobile =$receiverProvinceName = 李先生;$receiverCityName = 深圳市;$receiverExpAreaName = 福田区;$receiverAddress = 赛格广场5401AB;$commodityOne = ;$commodityOneGoodsName = 其他;$commodity = ;$commodity = $commodityOne;$eorderSender = $sender;$eorderReceiver = $receiver;$eorderCommodity = $commodity;/调用电子面单$jsonParam = json_encode($eorder, JSON_UNESCAPED_UNICODE);/$jsonParam = JSON($eorder);/兼容php5.2（含）以下echo 电子面单接口提交内容：.$jsonParam;$jsonResult = submitEOrder($jsonParam);echo 电子面单提交结果:.$jsonResult;/解析电子面单返回结果$result = json_decode($jsonResult, true);echo 返回码:.$resultResultCode;if($resultResultCode = 100) echo 是否成功:.$resultSuccess;else echo 电子面单下单失败;/-/* * Json方式 查询订单物流轨迹 */function submitEOrder($requestData)$datas = array( EBusinessID = EBusinessID, RequestType = 1007, RequestData = urlencode($requestData) , DataType = 2, ); $datasDataSign = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根据公司业务处理返回的信息.return $result; /* * post提交数据 * param string $url 请求Url * param array $datas 提交的数据 * return url响应返回的html */function sendPost($url, $datas) $temps = array(); foreach ($datas as $key = $value) $temps = sprintf(%s=%s, $key, $value); $post_data = implode(&, $temps); $url_info = parse_url($url);if($url_infoport=)$url_infoport=80;echo $url_infoport; $httpheader = POST . $url_infopath . HTTP/1.0rn; $httpheader.= Host: . $url_infohost . rn; $httpheader.= Content-Type:application/x-www-form-urlencodedrn; $httpheader.= Content-Length: . strlen($post_data) . rn; $httpheader.= Connection:closernrn; $httpheader.= $post_data; $fd = fsockopen($url_infohost, $url_infoport); fwrite($fd, $httpheader); $gets = ;$headerFlag = true;while (!feof($fd) if ($header = fgets($fd) & ($header = rn | $header = n) break; while (!feof($fd) $gets.= fread($fd, 128); fclose($fd); return $gets;/* * 电商Sign签名生成 * param data 内容 * param appkey Appkey * return DataSign签名 */function encrypt($data, $appkey) return urlencode(base64_encode(md5($data.$appkey);/* * * 使用特定function对数组中所有元素做处理 * param string &$array 要处理的字符串 * param string $function 要执行的函数 * return boolean $apply_to_keys_also 是否也应用到key上 * access public * */ function arrayRecursive(&$array, $function, $apply_to_keys_also = false) static $recursive_counter = 0; if (+$recursive_counter 1000) die(possible deep recursion attack); foreach ($array as $key = $value) if (is_array($value) arrayRecursive($array$key, $function, $apply_to_keys_also); else $array$key = $function($value); if ($apply_to_keys_also & is_string($key) $new_key = $function($key); if ($new_key != $key) $array$new_key = $array$key; unset($array$key)