手机号在网时长

本文介绍手机号在网时长API接口的使用方式和参数声明。

接口信息

  • 接口名:MobileOnlineTime

  • 服务地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)

  • 请求方法:POST和GET。

  • 传输协议:HTTPS。

  • 接口说明: 传入手机号,查询手机号在网时长。

  • QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

加密方式:

  • normal:明文不加密

  • md5:MD5加密

重要
  • 所有参数的密文均取32位小写MD5字符串形式。

  • 不同MD5工具得出的密文可能不同,如果加密前接口可以调通但加密后不行,请尝试更换MD5工具。

normal

Mobile

String

手机号:

  • paramType 传 normal 时:传入手机号明文。

  • paramType 传 md5 时:传入手机号密文。

  • 明文:186****2055

  • 密文:

    849169cd3b20621c1c78bd61a11a4fc2

响应参数

名称

类型

描述

示例值

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039795

Message

String

返回信息。

success

Code

String

返回码:200为成功,其他为失败。

重要
  • 此参数代表是否正确调用了接口,详细的返回码说明请参见错误码

  • 业务核验结果请通过ResultObject中的字段查看。

200

ResultObject

BizCode

String

查询结果:

  • 1:有查询结果(计费)

  • 3:无查询结果(不计费)

1

TimeCode

String

代表手机号在网时长区间的数字:

  • 1:[0,3)

  • 2:[3,6)

  • 3:[6,12)

  • 4:[12,24)

  • 5:[24,+)

说明

举例:

  • 返回值为3,代表手机号在网6~12个月。

  • 返回值为5,代表手机号在网24个月以上。

5

IspName

String

运营商名称:

  • CMCC:移动

  • CUCC:联通

  • CTCC:电信

CMCC

SDK​调用示例

您可以通过在线平台直接调试API,请参见OpenAPI平台。同时阿里云也提供了多语言的调用示例,请参见代码示例

重要

集成前请确认您已获取AccessKey,并已配置环境变量。具体操作,请参见AccessKey在Linux、macOS和Windows系统配置环境变量