号码实时查询
最后更新于:2022-04-02 08:17:21
## 号码实时查询
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/44/d9/44d95414e38579df738a5768462719d8_202x204.png)
直连三大运营商接口,实时反馈查询结果 准确率100%。
## 接口费用([点击购买](https://market.topthink.com/product/102))
> 最低 0.2元/次
## 接口调用([调用须知](https://docs.topthink.com/think-api/1835086))
### 请求地址
```
GET https://api.topthink.com/unn/status
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是 |string| 用户授权码,参考[API调用](https://docs.topthink.com/think-api/1835086) |
| mobiles| 是 | string | 检测手机号,1-50个,仅支持国内号码,11位 , 多个号码之间用英文半角逗号分隔|
| orderNo| 是 | string | 业务唯一流水号,需要用户提供|
### 返回`data`参数
|字段名|类型|说明|
|---|---|---|
|mobile|String|手机号|
|handleTime|String|查询时间 例:2018-04-09 15:05:01|
|area|String|手机号所属区域。样例:省-市|
|numberType|String|运营商类型 1移动 2联通 3电信|
|status|String|检测结果,1(正常) 2(空号) 3(通话中) 4(在网但不可用) 5(关机) 6(呼叫转移) 7(疑似关机) 13(停机) 11(携号转网) 10(未知)|
|remark|String|备注 ,例:中国联通 GSM/3G-正常|
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->unnStatus()
->withMobile('手机号码')
->withOrderNo()
->request();
```
返回示例:
~~~
{
"code":0,
"message":"操作成功",
"data":{
orderNo: "20200801",
handleTime: "2020-08-14 23:29:30",
mobile: "13817585871",
area: "上海-上海",
numberType: "1",
status: "1",
remark: "中国移动-OK"
}
}
~~~
';