在数字化浪潮下,身份证实名认证已经成为线上服务的刚需。无论是电商平台的订单提交、在线教育的课程报名,还是医疗健康领域的患者建档,企业都要快速、精准地获取用户身份信息。身份证识别API能够高效帮助获取信息,该api通过自动化处理身份证图像,提取结构化数据(如姓名、身份证号、地址等),帮助企业实现高效实名认证、用户信息管理与合规性要求。
电商平台:订单信息自动化,自动识别收货人信息,减少手动输入错误,提高下单效率,使顾客满意。
医疗健康:帮助患者信息管理,在挂号、住院登记时,通过身份证识别快速关联患者健康档案,缩短人工录入时间。还可以将身份证信息直接同步至电子病历,确保患者信息的准确性与一致性。
教育平台:课程报名实名认证,在线教育平台通过身份证识别验证学员身份,满足教育部门的合规要求,还可以考试防作弊保障考试公平性。
接口地址:https://api.tanshuapi.com/api/ocr_idcard/v1/index
返回格式:json
请求参数说明:
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 个人中心查看 |
img | 是 | string | 图像数据,base64编码后post请求,要求base64编码后大小不超过1M,支持jpg/jpeg/png格式。 |
side | 是 | string | front:正面识别;back:反面识别; |
返回参数说明:
名称 | 类型 | 说明 |
---|---|---|
side | string | 识别面 |
realname | string | 姓名 |
nation | string | 民族 |
address | string | 地址 |
idcard | string | 号码 |
born | string | 生日 |
sex | string | 性别 |
photo | string | 头像base64 |
enddate | string | 到期日期(side=back时返回) |
department | string | 所在机关(side=back时返回) |
begindate | string | 发证日期(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代码示例:
<?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可以实现效率提升、成本降低与合规性保障。