一、接口名称：

空号检测接口

二、接口介绍：

空号检测api是指通过手机号码查询其在网活跃度，返回包括空号、实号、停机、库无、沉默号、风险号等状态。

三、API接口文档

1、请求地址

https://api.shumaidata.com/v4/mobile_empty/check

请求方式：GET

参数：

2、签名算法说明：

商户分配的appid、当前时间毫秒数timestamp、商户分配的app_security、三者通过&符号拼接成字符串进行md5加密得到。

如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc;

拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc;

加密后得到sign=md5(str)=4e7e1974b79f3656aeaf03f1158f5d5d;

3、正确返回：

{

"msg":"成功",

"success":true,

"code":200,

"data":{

"order_no":"585862999579955200",

"area":"浙江-杭州",

"channel":"中国移动GSM",

"status":1

}

}

4、错误返回：

{

"msg":"不支持的号段",

"success":false,

"code":400,

"data":{}

}

5、返回字段说明：

6、code错误码说明

7、手机号状态解释

实号含意：实号包即为活跃号码包，（命中准确率100%，误差率5%)出现误差原因：可能意外停机

沉默号：沉默包即为超过六个月未激活过的空号和近三个月平均流量低于30M的用户（可理解为不活跃包），因为运营商的空号保存期为六个月，超过六个月的空号可能随时投入市场变成实号，且近三个月平均流量低于30M的用户也有可能随时停机，为确定数据的准确性，独立分包

空号：近一个月内出现过的空号和停机号（命中准确率100%误差率：5%）出现误差的原因，可能停机的手机号恢复使用，我们每一条数据都通过运营商系统查询，但为了降低成本，营销层面的数据系统查询保留一个月

风险号：长时间关机或未开通语音服务以及易投诉的用户

》》》》》延伸接口推荐：手机实时在网状态查询接口