文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 号码管理/ 查询号码归属地(getPhoneNoRegionInfo)
更新时间:2023-09-27 GMT+08:00

查询号码归属地(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"
}