三网手机实名认证详版
最后更新于：2022-04-02 08:16:29
## 三网手机实名制认证（详版）
> 检验姓名、身份证、手机号码是否一致，并返回不一致详情，支持移动、联通和电信。
## 接口费用（[点击购买](https://market.topthink.com/product/314)）
> 最低 0.32元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/telecom/detail
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 | string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| realname | 是 | string | 姓名 |
| idcard | 是 | string | 身份证号码 |
| mobile | 是 | string | 手机号码 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| res | int| 匹配结果 1 匹配 2 不匹配 |
| resmsg| string | 匹配说明 |
| type | string | 手机运营商 |
| province| string | 归属地省 |
| city| string | 归属地市 |
| rescode| string | 11:匹配,21:姓名不匹配,22:身份证不匹配,23:姓名身份证均不匹配,33:身份证和姓名不一致|
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->telecomDetail()
->withIdcard('身份证号码')
->withRealname('真实姓名')
->withMobile('手机号码')
->request();
dump($result);
```
返回数据示例：
~~~
{
"message": "查询成功",
"data": {
"orderid":"J339201812031141197115QV",/*流水号*/
"res": 2,/*匹配结果：1匹配 2不匹配*/
"resmsg": "三要素身份验证不一致",/*说明*/
"type": "移动",/*手机运营商*/
"province":"广东省",/*归属地省*/
"city" : "惠州市",/**归属地城市*/
"rescode":"24",/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,
23:姓名身份证均不匹配*/
},
"code": 0
}
~~~
>[danger] 返回`code`为0时计费。
';