首页 >号码百科 >API参考 >API目录 >其他 >DescribePhoneNumberAnalysis - 查询号码分析结果

DescribePhoneNumberAnalysis - 查询号码分析结果

根据授权码实时调用DescribePhoneNumberAnalysis接口,获取号码分析返回结果。

接口说明

使用说明

此接口需开通号码分析服务才能调用,详情请咨询您的商务经理。

QPS限制

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

授权信息

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

调试

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

调试

授权信息

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

请求参数

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

授权码。

说明标签广场选择标签,提交使用申请,申请通过后,会获得该授权码。
QASDW@#**
InputNumberstring

待查询的号码。

1310000****
NumberTypeinteger

号码类型。取值:

  • 0:手机号

  • 1:手机IMEI号

0
Maskstring

号码的加密方式。取值:

  • NORMAL:不加密

  • MD5

  • SHA256

MD5
RateLong

号码分数阈值。取值范围:0~100

说明是否接受指定的分数阈值由服务端决定。当不接受指定分数阈值时,此字段输入的数据无效。
10

返回参数

名称类型描述示例值
object
RequestIdstring

请求ID。

CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47
Codestring

请求状态码。取值:

  • OK:成功。
说明请求状态码详情请参见下表:状态码原因及解决方案、异常原因及解决方案。
OK
Messagestring

号码状态的描述。

OK
Dataarray

号码分析返回结果信息。

object

1

Codestring

返回的结果编码。

  • YES:有效

  • NO:无效

  • UNKNOWN:未知

YES
Numberstring

输入的号码。

1310000****

状态码原因及解决方案

HttpCode返回码描述解决方案
200OK成功。表示接口调用成功。

异常原因及解决方案

HttpCode错误码描述解决方案
400MobileNumberIllegal手机号非法。若手机号未加密,填入11位正确的数字号码即可;若手机号经MD5加密处理,该字段为32位加密字符串;若手机号经SHA256加密处理,该字段为64位加密字符串。
400EncyrptTypeIllegal加密类型非法。加密方式仅支持NORMAL、MD5、SHA256三种,且必须为大写字符。
400MobileNumberTypeNotMatch手机号码与加密类型不匹配。请您填入正确手机号格式和号码加密类型。
400AuthCodeNotExist授权码不存在或不可用。授权码不存在或授权码未通过审核,请您核实授权码的正确性。
400TagNotExist标签或业务资源不存在。标签不存在或业务资源不存在,请核实标签的可用性。
400RateIllegal阈值参数非法。阈值参数非法,请检查阈值参数是否合规。
400InvalidParameter非法参数。请求参数错误,请检查参数是否正确。
400System.LimitControl流控错误。请将查询频率限制在正常范围内,对于出现该错误码的号码适当进行重查,建议重复查询的次数不要超过3次。若的确有大并发的场景和需求,请创建工单联系工程师处理。
500SystemError系统异常。系统错误,请稍后重试。

示例

正常返回示例

JSON格式

{
  "RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
  "Code": "OK",
  "Message": "OK",
  "Data": [
    {
      "Code": "YES",
      "Number": "1310000****"
    }
  ]
}

错误码

Http code错误码错误信息描述
400Product.UnsubscriptYou have not subscribed to the specified product.未订阅该功能
400Ram.PermissionDenyYou are not authorized to perform the operation.权限不足
400System.LimitControlThe system is under flow control.系统限流控制
400Unknown.ResourceOwnerIdThe resource does not belong to the current user.资源不属于当前用户
400MobileNumberIllegalWrong format of phone number手机号码格式错误
400EncyrptTypeIllegalThe encryption type of the mobile phone number is illegal手机号加密类型非法
400MobileNumberTypeNotMatchPhone number and encryption type do not match输入手机号和加密类型不匹配
400CarrierIllegalIllegal carrier type运营商类型非法
400AuthCodeNotExistThe authorization code does not exist or fails to pass the audit授权码不存在,或不可用。
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.授权码不存在,或不可用。
400TagNotExistTag or business resource does not exist标签或业务资源不存在。
400TagNotExistTag or business resource does not exist.标签或业务资源不存在
400RateIllegalIllegal threshold parameter阈值参数非法
400InvalidParameterinvalid parameter-
403Permission.NotAuthorizedYou are not authorized to perform the operation.您没有权限执行此操作
500InternalErrorA system error occurred.系统异常
500SystemErrorA system error occurred.-
500SystemErrorAn error occurred while processing your request.系统异常

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

阿里云首页 号码百科 相关技术圈