智能識別快遞地址api介面實現（PHP樣本）

標籤：開發人員帳號   rpo   任務   要求   使用者id   正式   tab   content   charset   

電商、ERP等行業發貨時，批量錄入圖片上的收件者地址是個難題；智能識別收件者API是近乎完美的解決方案，通過識別圖片，解析出圖片中收件者的姓名、電話、詳細地址（省、市、區/縣、詳細地址）。將此介面整合到下單環節，可極大的提高了發貨效率。

一、使用情境

情境1：客戶（或QQ、DingTalk等）收件者資訊及地址

情境2：快遞單上面的收件者資訊及地址

情境3：手寫收件者資訊及地址

 

二、智能識別收件者服務使用流程

1、註冊快寶開放平台，擷取開發人員帳號，並認證資質：http://open.kuaidihelp.com/home

2、技術對接並調試，對接協助

3、應用於您軟體的下單環節

 

三、技術對接樣本（PHP代碼）

智能識別收件者

介面名稱：cloud.address.ocr

正式地址：https://kop.kuaidihelp.com/api

請求方式：HTTP POST

要求方法編碼格式：utf-8

公用請求參數：

名稱	類型	是否必須	描述
method	string	是	API介面名稱
app_id	string	是	使用者ID（註冊開放平台時分配，在控制台中查看）
sign	string	是	按照規則(md5(app_id + method + ts + api_key))產生的驗證合法性簽名
ts	string	是	當前請求的時間戳記
data	string	是	JSON格式請求參數設定

請求響應參數：

名稱	類型	是否必須	描述
code	int	是	響應狀態代碼。0-成功，非0-失敗下載並查看詳情
msg	string	是	返回結果說明
uid	string	是	本次請求唯一業務流水號
data	string	是	JSON格式響應資料

請求參數：

名稱	類型	是否必須	描述
url	string	是	圖片地址。帶上http或https的首碼

響應參數：

名稱	類型	是否必須	描述
name	string	是	名字
mobile	string	是	手機號碼
tel	string	是	固定電話
detail	data	是	解析詳情
remark	string	是	備忘資訊
province	string	是	省份
province_alias	string	是	省別名
city	string	是	城市
city_alias	string	是	城市別名
district	string	是	區或縣
district_alias	string	是	區或縣別名
address	string	是	地址資訊

支援Java，C#，Python，PHP，Node.js，Curl等6中語言接入，下面以PHP為例，展示發送請求任務程式碼範例。

 1 $host = "https://kop.kuaidihelp.com/api"; 2 $method = "POST"; 3 $headers = array(); 4 //根據API的要求，定義相對應的Content-Type 5 array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8"); 6 $querys = ""; 7 $bodys = [ 8 "app_id"=>‘50001‘, 9 "method"=>‘cloud.address.ocr‘,10 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",11 "ts"=>‘1524209949‘,12 "data"=>‘{ "url":"http://upload.kuaidihelp.com/1520929251015998700112.jpg" }‘13 ];14 $bodys = http_build_query($bodys);15 $url = $host;16 $curl = curl_init();17 curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);18 curl_setopt($curl, CURLOPT_URL, $url);19 curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);20 curl_setopt($curl, CURLOPT_FAILONERROR, false);21 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);22 curl_setopt($curl, CURLOPT_HEADER, true);23 if (1 == strpos("$".$host, "https://"))24 {25     curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);26     curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);27 }28 curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);29 var_dump(curl_exec($curl));

成功響應樣本

 1 { 2 "code":int0 3 "msg":string"success" 4 "data":{ 5 "name":string"張國明" 6 "mobile":string"13522128888" 7 "tel":string"" 8 "detail":{ 9 "remark":string""10 "province":string"上海市"11 "province_alias":string"上海"12 "city":string"上海市"13 "city_alias":string"上海"14 "district":string"虹口區"15 "district_alias":string"虹口"16 "address":string"廣靈一路友誼二村88號502"17 }18 }19 "uid":string"0b767b8f632612c6fbfb44a55d924c6a7f66eedc"20 }

異常響應樣本

1 {2 "code":string"錯誤碼"3 "msg":string"錯誤資訊"4 "data":{5 }6 }

錯誤碼

錯誤碼	描述
400001	業務參數有誤
400002	超出批量解析最大數量限制
400003	輸入字元太少
400004	請求方式錯誤
400005	請求資料格式錯誤
400006	缺少必要的參數
400007	類型不合法
400008	不支援的快遞品牌

-the end-

智能識別快遞地址api介面實現（PHP樣本）