DescribePhoneTwiceTelVerify
验证手机号是否为运营商二次放号的号码,支持在一次请求中快速检验号码是否为二次放号
服务地址:
华东1 金融云
输入参数
只看必填
AuthCode授权码
InputNumber待查询的号码
Mask号码的加密方式
StartTime时间
插件下载了解更多
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 用户授权

请求参数

字段名称字段详情
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 次。
变更历史
变更时间变更内容概要操作
2024-04-02
变更错误码500
2023-09-12
变更错误码400
2023-05-17
删除请求参数ExtendFunction
2023-04-28
新增请求参数ExtendFunction
删除返回参数
2023-04-18
新增错误码200
  • 1
  • 2
  • 10 条/页