1. 接口描述

允许企业和开发者查询特定手机号码在运营商网络中的使用时长。

2. 使用场景

金融行业：通过分析手机号的在网时长来规避新号、无效号码的欺诈风险。

电信行业：定期检查用户的在网时长，以确保符合行业规定和用户协议。

营销行业：通过在网时长判断用户的活跃程度，为精准营销提供支持。

电商行业：根据用户的在网时长，提供个性化的推荐和优惠，增强用户体验。

广泛应用于用户行为分析、用户注册验证、广告投放、市场研IPC究、风险控制等领域。

3. 接口说明（号码在网时长）

3.1. 发起请求

3.1.1. 接口协议

HTTP  POST

3.1.2. 接口方法

https://api.juncyun.com/api/checkMobile/onlineTime

3.1.3. 报头定义

编码	列表	内容	备注
1）	Accept	application/json
2）	Content-Type	application/json;charset=utf-8

 

3.1.4. 请求参数

3.1.4.1. 请求参数列表

编码	列表	内容	备注
1）	accessKey	API调用账号（必填，从云极平台获取）
2）	accessSecret	API调用密钥（必填，从云极平台获取）
3）	phone	手机号码（必填）

 

3.1.4.2. 请求参数示例

{

  "accessKey":"87d0373b**********",

  "accessSecret":"b20d7c5e1c********************",

  "phone":"137xxxx"

}

 

3.1.5. 响应参数

3.1.5.1. 响应参数列表

编码	列表	内容	备注
1）	code	状态码200则为成功
2）	msg	状态说明
3）	success	处理是否成功:取值范围 true，false
4）	data	业务数据 如果失败则为空
5）	+rangeStart	在网时长范围起始值（含）, 单位为月
6）	+provider	1：电信 2：移动3：联通
7）	+reqNo	交易流水号
8）	+fee	是否扣费  0不收费1收费
9）	+resultType	以rangeStart+rangeEnd区间取值[0,3)值为1, [3,6)值为2, [6,12) 值为3,[12,24)值为4, [24,-1)值为5
10）	+rangeEnd	在网时长范围结束值（不含）,单位为月[0,3), [3,6), [6,12),

 

3.1.5.2. 响应成功参数示例

{

"code": 200,

"msg": "请求成功",

"success": true,

"data": "{

"rangeStart":24,

"provider":2,

"fee":1,

"reqNo":"AI1709522081187131790",

"resultType":5,

"rangeEnd":-1

}"

}

 

3.1.5.3. 结果码说明

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商