DescribeEmptyNumber_号码百科_API文档-阿里云OpenAPI开发者门户

接口说明

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

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

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

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

dytns:DescribeEmptyNumber	Create	全部资源 *	无	无

字段名称	字段详情
AuthCodestring	授权码。展开详情示例值:Dd1r***4id
InputNumberstring	待查询的号码。展开详情示例值:189****1234参考取值来源: PhoneNumberStatusForSms
Maskstring	号码的加密方式。取值：展开详情示例值:NORMAL

字段名称	字段详情
RequestIdstring	公共参数，每个请求返回的 ID 都是唯一的，可用于排查和定位问题。示例值:CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47
Messagestring	状态码的描述。示例值:OK
Dataobject	返回结果。
Codestring	返回状态码。取值：展开详情示例值:OK

没有我想要的错误码, 点击反馈

HTTP 状态码	错误码	错误信息	操作

400	InvalidParameter	Invalid parameter.	诊断
400	AuthCodeIllegal	Illegal authCode.	诊断
500	InternalError	A system error occurred.	诊断
500	RequestTimeout	Request supplier timed out.	诊断
500	RequestSupplierError	Request supplier error.	诊断