## 三网手机实名制认证  > 检验姓名、身份证、手机号码是否一致，支持移动、联通和电信。 ## 接口费用（[点击购买](https://market.topthink.com/product/72)） > 最低 0.28元/次 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ### 请求地址 ``` GET https://api.topthink.com/telecom/query ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | realname | 是 | string | 姓名 | | idcard | 是 | string | 身份证号码 | | mobile | 是 | string | 手机号码 | | type | 否 | int | 1:返回手机运营商,不输入及其他值则不返回 | | province | 否 | int | 1:返回手机号归属地，province,city,不输入不返回 | ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | realname | string | 姓名 | | idcard | string | 身份证号码 | | mobile | string | 手机号码 | | res | int| 匹配结果 1 匹配 2 不匹配 | | resmsg| string | 匹配说明 | | type | string | 手机运营商 | | province| string | 归属地省 | | city| string | 归属地市 | | rescode| string | 11:匹配,24:不匹配,具体要素不匹配未知 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->telecomQuery() ->withIdcard('身份证号码') ->withRealname('真实姓名') ->withMobile('手机号码') ->withProvince(1) ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": { "realname": "***", "mobile": "***********", "idcard": "******************", "res": 2, "resmsg": "三要素身份验证不一致," "type": "移动"/*手机运营商,输入参数type为1时返回*/ "orderid":"J201712251904163782Ay", "province":"广东省",/*归属地省*/ "city" : "惠州市",/**归属地城市*/ "rescode":"24", }, "code": 0 } ~~~ >[danger] 返回`code`为0时计费。