智能識別快遞地址api接口實現（PHP示例）

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

一、使用場景

場景1：客戶微信（或QQ、釘釘等）截圖收件人信息及地址

場景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為例，展示發送請求任務代碼示例。

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根據API的要求，定義相對應的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'50001',
"method"=>'cloud.address.ocr',
"sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
"ts"=>'1524209949',
"data"=>'{ "url":"http://upload.kuaidihelp.com/1520929251015998700112.jpg" }'
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));

成功響應示例

{
"code":int0
"msg":string"success"
"data":{
"name":string"張國明"
"mobile":string"13522128888"
"tel":string""
"detail":{
"remark":string""
"province":string"上海市"
"province_alias":string"上海"
"city":string"上海市"
"city_alias":string"上海"
"district":string"虹口區"
"district_alias":string"虹口"
"address":string"廣靈一路友誼二村88號502"
}
}
"uid":string"0b767b8f632612c6fbfb44a55d924c6a7f66eedc"
}

異常響應示例

{
"code":string"錯誤代碼"
"msg":string"錯誤信息"
"data":{
}
}

錯誤碼

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

-the end-