身份证文字识别
最后更新于：2022-04-02 08:17:03
## 身份证文字识别
> 支持对二代居民身份证正反面的关键字段识别，包括姓名、性别、民族、出生日期、住址、 身份证号、签发机关、有效期限，准确率98%以上
>[danger] 身份证文字识别 不能替代身份证认证，仅用于提取相关信息进一步进行身份认证。
## 接口费用（ [点击购买](https://market.topthink.com/product/105)）
> 最低 0.012元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
POST https://api.topthink.com/ocr/id_card_text
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| image | 是 | string | 身份证照片，请确保身份证内容信息清晰可见。支持url或base64，图片大小不能大于2M，图片类型建议jpg格式，1M左右 |
| imageType| 是 | string | 图片类型，枚举值：URL-图片路径；BASE64 –图片BASE64编码 |
| ocrType| 是 | string | ocr类型，0表示身份证正面，1表示身份证反面 |
| detectRisk| 否 | string | 是否开启身份证风险类型(身份证复印件)功能，默认不开启，即：false。可选值:true-开启；false-不开启 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| \- | \- | 见返回数据示例 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->ocrIdcardText()
->withImage('图像数据')
->withImageType('URL')
->withOcrType(0)
->request();
dump($result);
```
身份证正面识别结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"address": "地址",
"birth": "出生日期",
"name": "姓名",
"cardNum": "身份证编号",
"sex": "性别",
"nation": "民族",
"imageStatus": "图像状态",
"riskType": "身份证风险类型",
"direction": "图像方向"
}
}
```
身份证背面识别结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"issuingDate": "20130501",/*签发日期*/
"issuingAuthority": "东台市公安局",/*签发机关*/
"expiryDate": "20180501",/*失效日期*/
"imageStatus": "图像状态",
"riskType": "身份证风险类型",
"direction": "图像方向"
}
}
```
';