
# 查询号码归属地（getPhoneNoRegionInfo）
#### 场景描述
查询号码归属地，支持手机号码和固话。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/phonearea/getPhoneNoRegionInfo，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | X-APP-KEY     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                                 |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号  | 名称      | 参数类型   | 是否必选 | 说明                  |
|:---|:---|:---|:---|:---|
| 1.1 | phoneNo | string | True | 查询的11位手机号码，或者带区号固话。 |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号    | 名称          | 参数类型   | 是否必选  | 说明                                                                                                                                   |
  |:---|:---|:---|:---|:---|
  | 1.1   | returnCode  | string | False | 返回码，0成功，非0失败                                                                                                                         |
  | 1.2   | description | string | False | 返回描述                                                                                                                                 |
  | 1.3   | data        | object | False | 手机号码归属地信息                                                                                                                            |
  | 1.3.1 | areaCode    | string | False | 地区码                                                                                                                                  |
  | 1.3.2 | province    | string | False | 省                                                                                                                                    |
  | 1.3.3 | city        | string | False | 城市                                                                                                                                   |
  | 1.3.4 | cityCode    | string | False | 城市编码，可能多个，"/"分隔，如果查询的是固话，城市编码可能为空                                                                                                    |
  | 1.3.5 | isp         | string | False | 运营商：电信、移动、联通。 如果是固话查询则返回未知 |
  | 1.3.6 | postCode    | string | False | 邮政编码，可能多个，"/"分隔，如果查询的是固话，邮政编码可能为空                                                                                                    |
  | 1.3.7 | phoneNo     | string | False | 手机号码前7位，或者固话区号                                                                                                                       |
     
  
- **响应状态码: 401**
  授权失败：1. 参数是否正确有效。 2. 请确认是否购买了相关服务。 3. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求路径可能不对。
  
- **响应状态码: 500**
  参数不对导致业务失败或者服务端内部异常。
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type: application/json
X-APP-KEY: **************************************
Authorization: Bearer **************************************
```
请求参数:
```
{"phoneNo":"13020017****"}
```
响应参数:
```
{
  "returnCode": "0",
  "data": {
    "areaCode": "110100",
    "province": "北京",
    "city": "北京",
    "cityCode": "010",
    "isp": "联通",
    "postCode": "100000",
    "phoneNo": "1302001"
  },
  "description": "success"
}
```
