## 三網手機實名制認證  > 檢驗姓名、身份證、手機號碼是否一致，支持移動、聯通和電信。 ## 接口費用（[點擊購買](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時計費。