DescribePhoneNumberOnlineTime
查询手机用户在运营商侧的在网时长
服务地址：
华东1 金融云
输入参数
只看必填
AuthCode授权码
InputNumber待查询的号码
Mask号码的加密方式
Carrier对外运营商
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

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

QPS 限制

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

请求参数

字段名称字段详情
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 次。
变更历史
暂无变更历史