首页 号码百科 API参考 API目录 号码归属查询 DescribePhoneNumberOperatorAttribute - 号码归属查询（加密版）

DescribePhoneNumberOperatorAttribute - 号码归属查询（加密版）

查询手机号码的归属信息，包括：所属省份、所属城市、所属基础运营商（中国移动、中国联通、中国电信、中国广电）、移动转售企业（阿里通信等）、是否携号转网、归属号码段等。

接口说明

  • 请确保在使用本接口前，您已充分了解号码百科产品计费。

  • 默认仅阿里云账号使用本接口，RAM用户只有在被授予相关API操作权限后才可使用。相关操作，请参见为RAM用户授权。

  • 本接口用于获取号码当前服务运营商、归属地和携号转网信息，支持明文、MD5、SHA256加密手机号码的查询。

  • 使用本接口前，请登录号码百科控制台，在标签广场页面，找到对应的标签，单击申请开通，填写申请资料，审批通过后即可使用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AuthCodestring是

授权码。

说明在号码百科控制台我的申请页面，获取授权ID即授权码。
Dd1r***4id
InputNumberstring是

待查询的号码。

  • 若Mask取值为NORMAL，该字段为11位手机号码。
  • 若Mask取值为MD5，该字段为32位加密字符串。
  • 若Mask取值为SHA256，该字段为64位加密字符串。
注意加密字符串中字母不区分大小写。
139****1234
Maskstring是

号码的加密方式。取值：

  • NORMAL：不加密
  • MD5：MD5加密
  • SHA256：SHA256加密
注意字符串中所有字母必须大写。
MD5

返回参数

名称类型描述示例值
object

返回数据。

Codestring

请求状态码。取值：

  • OK：成功。
  • InvalidParameter：传入的手机号错误或参数格式错误。
  • PhoneNumberNotfound：传入的手机号查不到归属结果。
  • isp.UNKNOWN：未知异常。
  • RequestFrequencyLimit：因运营商限制，禁止在短时间内高频对同一个号码进行反复查询，如返回此错误码，请您稍后再试。
OK
Messagestring

状态码的描述。

OK
RequestIdstring

请求ID。

68A40250-50CD-034C-B728-0BD135850177
Dataobject

结构体。

BasicCarrierstring

基础运营商。取值：

  • 中国移动。
  • 中国联通。
  • 中国电信。
中国移动
Carrierstring

实际运营商（含虚拟运营商），如果存在携号转网，则为携转后的运营商。

中国移动
IsNumberPortabilityboolean

是否携号转网。取值：

  • true：是

  • false：否

false
NumberSegmentlong

号码归属号段。

139
Citystring

号码归属城市。

杭州
Provincestring

号码归属省份。

浙江

状态码原因及解决方案

状态码原因解决方案
OK：成功。请求参数符合要求。表示接口调用成功。
InvalidParameter：传入的手机号错误或参数格式错误。请求参数的手机号格式错误或请求参数不符合API接口的要求。输入正确的手机号或调整请求参数的格式，再重新提交请求。如：删除手机号中的不可见字符、空格、调整为半角字符等。
PhoneNumberNotfound：传入的手机号查不到归属结果。传入的手机号查不到归属结果。请更换其他手机号查询。
isp.UNKNOWN：未知异常。系统返回了未知异常。请尝试重新调用接口，建议重试的次数不要超过3次。

BasicCarrier和Carrier字段含义：

手机号段归属是否有携号转网BasicCarrier字段返回结果Carrier字段返回结果
基础运营商号段是携转后基础运营商（中国移动、中国联通、中国电信）携转后基础运营商（中国移动、中国联通、中国电信）
基础运营商号段否基础运营商（中国移动、中国联通、中国电信）基础运营商（中国移动、中国联通、中国电信）
虚拟运营商号段暂不支持基础运营商（中国移动、中国联通、中国电信）虚拟运营商（如：阿里云通信等）

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Message": "OK",
  "RequestId": "68A40250-50CD-034C-B728-0BD135850177",
  "Data": {
    "BasicCarrier": "中国移动",
    "Carrier": "中国移动",
    "IsNumberPortability": true,
    "NumberSegment": 139,
    "City": "杭州",
    "Province": "浙江"
  }
}

错误码

HTTP status code错误码错误信息描述
400EncyrptTypeIllegalThe encryption type of the mobile phone number is illegal手机号加密类型非法
400MobileNumberTypeNotMatchPhone number and encryption type do not match-
400AuthCodeNotExistAuthorization code does not exist-
400AuthCodeNotExistThe authorization code does not exist or fails to pass the audit.-
400AuthCodeNotExistThe authorization code does not exist or fails to pass the audit. Please verify whether the authorization code is correct.-
400AuthCodeNotExistThe authorization code does not exist or fails to pass the audit-
400MobileNumberIllegalWrong format of phone number.-
400InvalidParameterThe specified mobile phone number is invalid.非法号码
400PhoneNumberNotfoundThe queried number is not found.传入的手机号未查到归属结果
400InvalidParameterThe specified parameter is invalid.非法参数
500InternalErrorA system error occurred.系统异常

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-06-28新增 OpenAPI
阿里云首页 号码百科 相关技术圈