调用PhoneNumberStatusForPublic通用场景下号码状态查询

接口说明

请确保在使用本接口前，您已充分了解号码百科产品定价。
默认仅阿里云账号使用本接口，RAM 用户只有在被授予相关 API 操作权限后才可使用。相关操作，请参见为 RAM 用户授权。
使用本接口前，请登录号码百科控制台，在标签广场页面，找到对应的标签，单击申请开通，填写申请资料，审批通过后即可使用。
号码状态查询功能目前支持中国电信、中国联通、中国移动和中国广电号码。

QPS 限制

本接口的单用户 QPS 限制为 300 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dytns:PhoneNumberStatusForPublic

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AuthCode	string	是	授权码。说明在号码百科控制台我的申请页面，获取授权 ID 即授权码。	Dd1r***4id
InputNumber	string	否	待查询的号码。若 Mask 取值为 NORMAL，该字段为 11 位手机号码。若 Mask 取值为 MD5，该字段为 32 位加密字符串。若 Mask 取值为 SHA256，该字段为 64 位加密字符串。若 Mask 取值为 SM3，该字段为 64 位加密字符串。说明加密字符串中字母不区分大小写。	139****1234
Mask	string	是	加密方式。取值： NORMAL：不加密 MD5 SHA256 SM3	NORMAL

返回参数

名称	类型	描述	示例值
	object	结构体
RequestId	string	公共参数，每个请求返回的 ID 都是唯一的，可用于排查和定位问题。	CC3BB6D2-**-**-9DCE-B38165CE4C47
Message	string	返回状态码描述。	OK
Data	object	结构体
Status	string	检测手机号返回状态。取值： NORMAL：正常。 SHUTDOWN：停机。 POWER_OFF：关机。 NOT_EXIST：空号。 SUSPECTED_POWER_OFF ：疑似关机。 BUSY：忙。 UNKNOWN：未知。说明因运营商系统调整，中国电信的号码不支持返回：忙、疑似关机、关机状态。详见官网公告	NORMAL
Carrier	string	号码当前归属的基础运营商。如果查询的号码存在携号转网，则返回携号转网后的基础运营商。取值： CMCC：中国移动。 CUCC：中国联通。 CTCC：中国电信。说明暂不支持中国广电的号码查询。	CMCC
Code	string	请求状态码。取值： OK：成功。 OperatorLimit：运营商禁止查询的手机号。 RequestFrequencyLimit：因运营商限制，禁止在短时间内高频对同一个号码进行反复查询，如返回此错误码，请您稍后再试。说明请访问错误码中心查看更多错误码。	OK

示例

正常返回示例

JSON格式

{
  "RequestId": "CC3BB6D2-****-****-9DCE-B38165CE4C47",
  "Message": "OK",
  "Data": {
    "Status": "NORMAL",
    "Carrier": "CMCC"
  },
  "Code": "OK"
}

错误码

HTTP status code	错误码	错误信息	描述
200	OperatorLimit	The number is limited by the operator	运营商禁止查询的手机号
400	InvalidParameter	Invalid parameter.	无效参数
400	AuthCodeIllegal	Illegal authCode.	鉴权时使用的authcode不可用于该接口
500	InternalError	A system error occurred.	系统异常
500	RequestTimeout	Request supplier timed out.	请求供应商超时
500	RequestSupplierError	Request supplier error.	请求第三方服务异常。

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

变更历史

更多信息，参考变更详情。