## 身份证实名认证  > 检测姓名和身份证号是否一致，身份证验证。 ## 功能介绍 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时计费。