DescribePhoneTwiceTelVerify_号码百科_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请确保在使用本接口前,您已充分了解号码百科产品定价
  • 当返回结果中:Code="OK" 且 VerifyResult != 0 时计费,其他情况不计费。
  • 使用本接口前,请登录号码百科控制台,在标签广场页面,找到对应的标签,单击申请开通,填写申请资料,审批通过后即可使用。

QPS 限制

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

授权信息

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

流控信息

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

授权信息

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

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
dytns:DescribePhoneTwiceTelVerify
Create
全部资源
*

请求参数

字段名称字段详情
AuthCodestring

授权码。展开详情

示例值:Dd1r***4id
InputNumberstring

待查询的号码。展开详情

示例值:139*******参考取值来源:
    PhoneNumberStatusForSms
Maskstring

号码的加密方式。取值:展开详情

示例值:NORMAL
StartTimestring

时间,格式必须为 yyyy-MM-dd HH:mm:ss。该时间为手机用户在业务侧的注册时间。如果注册时间在运营商放号时间之后,则表示该号码不是二次号,否则返回结果是二次号。展开详情

示例值:2018-01-01 00:00:00

返回参数

字段名称字段详情
RequestIdstring

公共参数,每个请求返回的 ID 都是唯一的,可用于排查和定位问题。

示例值:68A40250-50CD-034C-B728-0BD135850177
Codestring

请求状态码。取值:展开详情

示例值:OK
Messagestring

状态码的描述。

示例值:OK
Dataobject

结构体。

返回说明

状态码原因及解决方案

HttpCode状态码原因解决方案
200OK:成功。请求参数符合要求。表示接口调用成功。
200PortabilityNumberNotSupported:不支持的携号转网号码。部分携号转网号码会返回此错误码。建议更换其他号码查询。携号转网的号码在原运营商侧已销户,新运营商侧认为携入的时间为开户时间,因此携号转网的号码无法准确的查询到该号码的真实情况。
200RequestNumberNotSupported:不支持查询的号码。不支持中国广电号码(192 开头)、虚拟运营商、和其他运营商不支持查询的号码。建议更换运营商支持查询的号码。

异常原因及解决方案

HttpCode状态码原因解决方案
400AuthCodeNotExist:授权码不存在。授权码不存在。请先在号码分析服务申请您所需的标签,申请成功并获得授权码后,再发起接口调用。
400MobileNumberIllegal:请求参数的手机号格式有误。手机号格式填写有误。若手机号未加密,填入 11 位正确的数字号码即可;若手机号经 MD5 加密处理,该字段为 32 位加密字符串;若手机号经 SHA256 加密处理,该字段为 64 位加密字符串。
400MobileNumberTypeIllegal:加密方式类型错误。不支持的加密方式或加密类型不规范。加密方式仅支持 NORMAL、MD5、SHA256 三种,且必须为大写字符。
500Unknown:未知异常。系统返回了未知异常。请您尝试重新调用接口,建议重试的次数不要超过 3 次。
500SystemError:网元系统异常。系统错误。请尝试重新调用接口,建议重试次数不要超过 3 次。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
200
PortabilityNumberNotSupported
不支持2021年6月前携号转网的号码查询诊断
200
RequestNumberNotSupported
不支持中国广电号码(192开头)和虚拟运营商号码的查询诊断
200
RequestFrequencyLimit
因运营商限制,禁止在短时间内高频对同一个号码进行反复查询诊断
400
Product.Unsubscript
You have not subscribed to the specified product.诊断
400
Ram.PermissionDeny
You are not authorized to perform the operation.诊断
400
System.LimitControl
The system is under flow control.诊断
400
Unknown.ResourceOwnerId
The resource does not belong to the current user.诊断
400
MobileNumberIllegal
Wrong format of phone number诊断
400
MobileNumberTypeNotMatch
Phone number and encryption type do not match诊断
400
InputParamIllegal
Wrong format of input parameter诊断
400
AuthCodeIllegal
Illegal authCode.诊断
400
ThresholdIllegal
Please fill in the threshold range from 0 to 100 correctly.诊断
400
AuthCodeNotExist
The label application form does not exist, please replace the authorization code.诊断
400
MobileNumberTypeIllegal
Invalid number type.诊断
400
TagNotExist
The label does not exist.诊断
400
InvalidParameter
Invalid parameter.诊断
500
Unknown
Unknown error诊断
500
SystemError
System error诊断
500
RequestSupplierError
Request supplier error.诊断
500
RequestTimeout
Request supplier timed out.诊断

变更历史

变更时间变更内容概要操作
2024-04-02
变更错误码500
2023-09-12
变更错误码400
2023-05-17
删除请求参数ExtendFunction
2023-04-28
新增请求参数ExtendFunction
删除返回参数
2023-04-18
新增错误码200
  • 1
  • 2
  • 10 条/页

相关示例