身份证实名认证
最后更新于：2022-04-02 08:16:24
## 身份证实名认证
> 检测姓名和身份证号是否一致，身份证验证。
## 功能介绍
1. 通过传递姓名+身份证号码，校验信息是否一致
2. 适用于电商、游戏、直播、金融等需要用户实名认证的场景。
## 接口费用 （[点击购买](https://market.topthink.com/product/71)）
> 最低 0.10元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/idcard/auth
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 | string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| idNum| 是 | string | 身份证号码 |
| name| 是 | string | 姓名(UTF-8) |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| orderNo| string | 业务唯一流水号。例：011569554991100011 |
| handleTime| string | 查询时间 例：2018-04-09 15:05:01 |
| province| string| 身份 |
| result| string| 返回结果 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定（收费） 04-认证失败(不收费) |
| gender| string | 性别，1-男 2-女 |
| age| string | 年龄 例：26 |
| remark| string| 备注 ，例：一致|
| city| string | 市 |
| country| string | 县区 |
| birthday| string| 生日|
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->idcardAuth()
->withIdNum('身份证号码')
->withName('真实姓名')
->request();
dump($result);
```
返回数据示例：
~~~
{
"code": 0,
"message": "成功",
"data": {
orderNo: "011569554991100011",
handleTime: "2018-06-29 13:18:24",
result: "02",
province: "湖南省",
city: "怀化市",
country: "辰溪县",
birthday: "19890725",
age: "29",
gender: "1",
remark: "不一致"
},
}
~~~
>[danger] 返回`code`为0时计费。
';