## 身份證實名認證  > 檢測姓名和身份證號是否一致，身份證驗證。 ## 功能介紹 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時計費。