1. 接口描述

通过手机号码的消费能力维度、在线频率维度划分活跃等级以此来判断手机号码是否活跃，方便客户进行精准营销，提升营销效果。

2. 使用场景

电话营销：去除无效号码，节约时间成本、提升成功率，提高人均产能。

短信营销：筛选出有价值的互联网活跃用户，节约营销成本，提高短信营销的转化率。

3. 接口说明

此接口不判断是否为正确手机号码，全部计费

3.1. 发起请求

3.1.1. 接口协议

HTTP  POST

3.1.2. 接口方法

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

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	手机号码（必填）	多个号码以英文半角逗号分隔，支持最多 500 个

 

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）	feeCount	计费条数
6）	fee	是否收费：0不收费，1收费
7）	reqNo	请求唯一标识
8）	mobile	手机号
9）	area	手机号所属区域。样例：省-市
10）	handleTime	时间戳
11）	numberType	手机号运营商类型。样例：中国移动 GSM
12）	status	检测结果，0-未知，1-优质号，2-活跃号，3-普通号

3.1.5.2. 响应成功参数示例

{

    "code": 200,

    "msg": "成功",

    "success": true,

    "data": {

        "feeCount": 1,

        "fee": 1,

        "reqNo": "AI1724309589440409459",

        "list": [

            {

                "area": "河南-郑州",

                "handleTime": "1724309589883",

                "numberType": "中国联通",

                "mobile": "156*******5",

                "status": "2"

            }

        ]

    }

}

 

3.1.5.3. 结果码说明

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

 

3.1.5.4. 号码活跃度检测常见问题

问题	处理方式
1.优质包是什么意思？	手机品牌、机型、所在城市、号码归属地、在网时长、流量使用情况等消费力方面较好的号码，如号码归属地所在城市为一线城市，使用手机价格也较高，经常浏览APP，上网频率非常频繁的号码。
2.活跃包是什么意思？	手机品牌、机型、所在城市、号码归属地、在网时长、流量使用情况等消费力方面良好的号码，如号码归属地所在城市 GDP 还可以，手机价格在三四千左右，上网频率较高的号码。
3.普通包是什么意思？	手机品牌、机型、所在城市、号码归属地、在网时长、流量使用情况等消费力方面一般的号码，如号码归属地非一线城市，手机价位一般，或者号码归属地虽然为一线城市，但手机价位千元以下，上网频率一般的号码。
4.未知包是什么意思	不活跃号码或未知状态的号码，包含空号。
5.数据更新周期多久？	数据每天更新。