身份证OCR识别
最后更新于：2022-04-02 08:16:58
## 身份证OCR识别
> 支持对二代居民身份证正反面的关键字段识别，包括姓名、性别、民族、出生日期、住址、 身份证号、签发机关、有效期限，准确率98%以上
>[danger] 身份证文字识别 不能替代身份证认证，仅用于提取相关信息进一步进行身份认证。
## 接口费用（ [点击购买](https://market.topthink.com/product/88)）
> 最低 0.07元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
POST https://api.topthink.com/ocr/idcard
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| image | 是 | string | 图像数据，base64编码(不包含data:image/jpeg;base64,)，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式 |
| side | 是 | string | front:正面识别;back:反面识别; |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| \- | \- | 见返回数据示例 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->ocrIdcard()
->withImage('图像数据')
->withSide('front')
->request();
dump($result);
```
身份证正面识别结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"realname": "张三",/*姓名*/
"sex": "男",/*性别*/
"nation": "侗",/*民族*/
"born": "19760613",/*出生日期*/
"address": "贵州省都匀市甘塘镇长红机器厂散居户169号",/*地址*/
"idcard": "522701197606131938",/*身份证号*/
"side": "front"，/*正面*/
"orderid": 339057896/*本次查询流水号*/
}
}
```
身份证背面识别结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"begin": "20130501",/*签发日期*/
"department": "东台市公安局",/*签发机关*/
"end": "20180501",/*失效日期*/
"side": "back",/*反面*/
"orderid": 478799279/*本次查询流水号*/
}
}
```
';