一文带你认识什么是身份证识别API

95 阅读2分钟

身份证识别API能够高效帮助获取信息,该api通过自动化处理身份证图像,提取结构化数据(如姓名、身份证号、地址等),帮助企业实现高效实名认证、用户信息管理与合规性要求。

使用示例

返回格式:json
请求参数说明:

名称必填类型说明
keystring个人中心查看
imgstring图像数据,base64编码后post请求,要求base64编码后大小不超过1M,支持jpg/jpeg/png格式。
sidestringfront:正面识别;back:反面识别;

返回参数说明:

名称类型说明
sidestring识别面
realnamestring姓名
nationstring民族
addressstring地址
idcardstring号码
bornstring生日
sexstring性别
photostring头像base64
enddatestring到期日期(side=back时返回)
departmentstring所在机关(side=back时返回)
begindatestring发证日期(side=back时返回)

JSON返回示例:

{  
  "code": 200,  
  "msg": "success",  
  "data": {  
    "side": "front",  
    "realname": "张三",  
    "nation": "汉",  
    "address": "浙江省杭州市西湖区文三路123号",  
    "idcard": "330102199001011234",  
    "born": "1990-01-01",  
    "sex": "男",  
    "photo": "/9j/4AAQSkZJRgABAQAAA..."  
  }  
}

PHP代码示例:

接口地址:https://www.tanshuapi.com/market/detail-92 
<?php  
// 读取身份证图片并转换为Base64编码  
$file = 'idcard.jpg';  
$base64Img = base64_encode(file_get_contents($file));  

// 发送POST请求  
$url = 'https://api.tanshuapi.com/api/ocr_idcard/v1/index';  
$data = [  
    'key' => 'your_api_key',  
    'img' => $base64Img,  
    'side' => 'front' // 根据需求选择front或back  
];  

$ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, $url);  
curl_setopt($ch, CURLOPT_POST, 1);  
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);  

$response = curl_exec($ch);  
curl_close($ch);  

// 解析响应  
$result = json_decode($response, true);  
if ($result['code'] == 200) {  
    echo "姓名:" . $result['data']['realname'];  
    echo "身份证号:" . $result['data']['idcard'];  
} else {  
    echo "错误:" . $result['msg']; // 可能包含如10001(错误的请求KEY)等错误码  
}

总结

身份证识别API具有高精度、低延迟、易集成的优势。通过该API可以实现效率提升、成本降低与合规性保障。