穩定好用的認證系列API合輯
你可能也喜歡這些API文章!
在Java中，下面這段代碼展示了如何使用 Java 發送 HTTP POST 請求到身份證OCR識別服務，以及如何處理服務的響應。需要注意的是，其中的 HttpUtils 類和依賴項需要從提供的鏈接下載并引入。此外，{{AppCode}} 部分需要替換為實際的應用程序代碼。
import com.mittang.util.HttpUtils;
import org.apache.http.HttpResponse;
import org.apache.http.util.EntityUtils;
import java.util.HashMap;
import java.util.Map;
?
public class Example {
public static void main(String[] args) throws Exception{
String host = "https://open.expauth.com";
String path = "/v2/ocr/idcard/front";
String method = "POST";
// "{{AppCode}}" 替換成您的 AppCode
String appcode = "{{AppCode}}";
Map<String, String> headers = new HashMap<>();
headers.put("X-Mce-Signature", "AppCode/" + appcode);
headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<>();
Map<String, String> bodys = new HashMap<>();
// 填充參數
bodys.put("img", "img");
?
try {
/**
* 重要提示如下:
* HttpUtils請從
* https://static.miitang.com/saas/simple/HttpUtils.java 下載
*
* 相應的依賴請參照
* https://static.miitang.com/saas/simple/pom.xml
*/
HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);
// 獲取 response 的 body
String resStr = EntityUtils.toString(response.getEntity());
System.out.println(resStr);
int statusCode = response.getStatusLine().getStatusCode();
if(statusCode == 200){
// 請求成功，可根據業務碼（請求體中的code）進行邏輯處理
} else if(statusCode == 610){
// 用戶輸入的參數問題，可直接提示用戶
} else if(statusCode == 611){
// 系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。 LOG it and 提示用戶
} else if(statusCode == 612){
// 用戶操作頻度問題，可提示用戶。 LOG it and 按業務特點做處理
} else if(statusCode >= 500 && statusCode < 600){
// 在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服
} else {
// 如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。
}
} catch (Exception e) {
e.printStackTrace();
}
}
}在Python中，使用 requests 庫發送 POST 請求到身份證OCR識別服務接口，根據響應狀態碼進行業務邏輯處理，包括成功、參數問題、數據問題、操作頻度問題和系統穩定性問題等的處理。
import json
import requests
?
?
if __name__ == '__main__':
?
url = "https://open.expauth.com/v2/ocr/idcard/front"
?
payload = json.dumps({
"img": "img"
})
?
headers = {
"Content-Type": "application/json",
# "{{AppCode}}" 替換為您的 AppCode
"X-Mce-Signature": "AppCode/{{AppCode}}"
}
?
response = requests.request("POST", url, headers=headers, data=payload)
status_code = response.status_code
print("headers:", response.headers)
print("http 狀態碼:", str(status_code))
print(response.text)
if status_code == 200:
"請求成功，可根據業務碼（請求體中的code）進行邏輯處理"
elif status_code == 610 :
"用戶輸入的參數問題，可直接提示用戶"
elif status_code == 611 :
"系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。 LOG it and 提示用戶"
elif status_code == 612 :
"用戶操作頻度問題，可提示用戶。 LOG it and 按業務特點做處理"
elif status_code >= 500 & status_code < 600 :
"在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服"
else:
"如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。"在PHP中，使用 cURL 發送 POST 請求到身份證OCR識別服務接口，處理并輸出相應的業務邏輯。它包括設置請求頭、發送請求、處理響應，根據響應狀態碼進行不同的業務邏輯處理，如成功、參數問題、數據問題、操作頻度問題、系統穩定性問題等。
<?php
$host = "https://open.expauth.com";
$path = "/v2/ocr/idcard/front";
$method = "POST";
$appcode = "{{您的AppCode}}";
$headers = array();
array_push($headers, "x-mce-signature:AppCode/" . $appcode);
//根據API的要求，定義相對應的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = "img=img";
$url = $host . $path;
?
$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);
$result = curl_exec($curl);
?
$header_size = curl_getinfo($curl, CURLINFO_HEADER_SIZE); // 獲得響應頭大小
$httpCode = curl_getinfo($curl,CURLINFO_HTTP_CODE);
$body = substr($result,$header_size);
?
curl_close($curl);
$retMap = json_decode($body, true);
$code = $retMap["code"];
?
?
echo $httpCode.PHP_EOL; // DEBUG
?
if($httpCode == 200){
// 請求成功，可根據業務碼（請求體中的code）進行邏輯處理
echo $retMap["code"].PHP_EOL;
echo $retMap["message"].PHP_EOL;
echo $retMap["hasFees"].PHP_EOL;
echo $retMap["fees"].PHP_EOL;
if($code == "FP00000"){
// SUCCESS
echo "SUCCESS";
}
else{
// FAILURE
echo "FAILURE";
}
} else {
echo $code.PHP_EOL; // DEBUG
?
if($httpCode == 610){
// 用戶輸入的參數問題，可直接提示用戶
$errors = $retMap["errors"];
$errorMap = null;
foreach($errors as $key=>$value){
foreach($value as $key2=>$value2){
$errorMap[$key] = $value2;
break;
}
}
// 轉化為 key:tip
echo($errorMap["idCardNo"].PHP_EOL);
echo($errorMap["name"].PHP_EOL);
} else if($httpCode == 611){
// 系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。 LOG it and 提示用戶
echo "修訂數據狀態，不要重復操作。".PHP_EOL;
} else if($httpCode == 612){
// 用戶操作頻度問題，可提示用戶。 LOG it and 按業務特點做處理
echo $retMap["message"].PHP_EOL;
} else if($httpCode >= 500 && $httpCode < 600){
// 在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服
// TODO: retry
echo "RETRY".PHP_EOL;
} else {
// 如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。
var_dump($retMap);
}
}
?>;未來，身份證OCR識別API有望在多個領域取得突破，包括金融、醫療、政府服務等。其快速、準確地識別身份信息的能力將為各行業帶來便利，推動數字化服務的普及和提升用戶體驗。同時，隨著對隱私和安全性的關注不斷升級，身份認證OCR API也將在不斷加強數據保護和隱私控制方面取得創新，以滿足不斷演進的用戶需求。
