查询号码归属地(getPhoneNoRegionInfo)
场景描述
查询号码归属地,支持手机号码和固话。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/phonearea/getPhoneNoRegionInfo,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
X-APP-KEY |
string |
False |
appKey字段,用户标识,请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
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" }