DescribePhoneNumberOnlineTime_号码百科_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.

接口说明

  • 使用本接口前,请登录号码百科控制台,在标签广场页面,找到对应的标签,单击申请开通,填写申请资料,审批通过后即可使用。
  • 请确保在使用本接口前,您已充分了解号码百科产品定价

QPS 限制

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

流控信息

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

授权信息

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

具体说明如下:展开详情

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

请求参数

字段名称字段详情
AuthCodestring

授权码。展开详情

示例值:QASDW@#**
InputNumberstring

待查询的号码。展开详情

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

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

示例值:NORMAL
Carrierstring

对外运营商。取值:展开详情

示例值:UNICOM

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47
Codestring

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

示例值:OK
Messagestring

号码状态码的描述。

示例值:OK
Dataobject

结构体。

返回说明

状态码原因及解决方案

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

异常原因及解决方案

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

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
200
PortabilityNumberNotSupported
Number portability is not supported诊断
400
Insufficient.Balance
You have an insufficient balance.诊断
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
AuthCodeNotExist
Authorization code does not exist诊断
400
CarrierIllegal
Illegal carrier type诊断
400
MobileNumberIllegal
Wrong format of phone number诊断
400
MobileNumberTypeNotMatch
Phone number and encryption type do not match诊断
400
MobileNumberTypeIllegal
Invalid number type.诊断
400
InvalidParameter
Invalid parameter.诊断
400
AuthCodeIllegal
Illegal authCode.诊断
500
SystemError
System error诊断
500
Unknown
Unknown error诊断
500
RequestTimeout
Request supplier timed out.诊断
500
RequestSupplierError
Request supplier error.诊断

变更历史

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

相关示例

查询手机用户在运营商侧的在网时长
2022-03-24