调用DescribeEmptyNumber接口实现手机号空号检测-号码百科-阿里云

接口说明

本接口用于验证号码是否为空号。发起调用该接口验证号码请求时，系统会根据验证次数计费，标准价为 0.01 元/次。请确保在使用该接口前，已充分了解本产品的收费方式和价格。
当返回结果中：Code="OK" 且 Status != UNKNOWN 时计费，其他情况不计费。
由于本产品通过 AI 算法预测手机号的空号概率，所以无法做到 100%准确。当前评估的准确率和召回率约为 95%左右。调用时请注意差别。
使用本接口前，请登录号码百科控制台，在标签广场页面，找到对应的标签，单击申请开通，填写申请资料，审批通过后即可使用。

QPS 限制

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

授权信息

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

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

dytns:DescribeEmptyNumber

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AuthCode	string	是	授权码。说明在号码百科控制台我的申请页面，获取授权 ID 即授权码。	Dd1r***4id
InputNumber	string	是	待查询的号码。说明目前仅支持单个号码查询。	189****1234
Mask	string	是	号码的加密方式。取值： NORMAL：不加密 MD5 SHA256	NORMAL

返回参数

名称	类型	描述	示例值
	object	结构体
RequestId	string	公共参数，每个请求返回的 ID 都是唯一的，可用于排查和定位问题。	CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47
Message	string	状态码的描述。	OK
Data	object	返回结果。
Status	string	检测手机号返回状态。取值： EMPTY：空号。 NORMAL：正常。 SUSPECT_EMPTY：疑似空号。 UNKNOWN：未知。	EMPTY
Number	string	传入的手机号。	189****1234
Code	string	返回状态码。取值： OK：成功。 InvalidPhoneNumber.Check：手机号非法。	OK

示例

正常返回示例

JSON格式

{
  "RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
  "Message": "OK",
  "Data": {
    "Status": "EMPTY",
    "Number": "189****1234"
  },
  "Code": "OK"
}

错误码

HTTP status code	错误码	错误信息	描述
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.	请求第三方服务异常。

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

变更历史

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