三网手机实名认证
最后更新于：2022-04-02 08:16:26
## 三网手机实名制认证
> 检验姓名、身份证、手机号码是否一致，支持移动、联通和电信。
## 接口费用（[点击购买](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时计费。
';