收起菜单
空号检测API接口

1.概览

空号检测,即号码检测、号码清洗、号码过滤,通过去除无效号码来提高营销和宣传的效果,同时降低成本。

2.接口说明

2.1请求URL

https://apis.shlianlu.com/empty/api/check

2.2请求方式

POST

2.3请求包头定义

Accept: application/json

Content-Type: application/json;charset=utf-8

3.请求参数

参数名
类型
必填
描述
example
MchId
String
企业ID:请登录联麓客户端点击(空号检测)进入概览页面获取
100***66
AppId
String
Appid:请登录联麓客户端点击(空号检测)进入概览页面获取
10*************00
PhoneList
Array of String
提交模板变量内容,根据平台创建模板变量数提交相应变量
["15587571285","15587571286"]
TimeStamp
String
Timestamp UNIX 时间戳
1647481897155
SignType
String
加密方式,固定值:MD5或者HMACSHA256
MD5
Signature
String
所有字段(短信内容,手机号不参与签名)排序拼接字符串,并在最后加上&key=Appkey(appkey为appid对应密钥),顺序为AppId=xxx&MchId=xxx&SignType=MD5&TimeStamp=xxx&key=xxx,用MD5加密所得32位字符串,转为大写
Signature 签名机制详解

4.示例

4.1请求示例

  
    {
      "PhoneList":["15587571285","15587571286"],
      "AppId":"10*************00",
      "MchId":"100***66",
      "Signature":"7993CE14A565F418BAF745432A9990F5", 签名机制详解
      "SignType":"MD5",
      "TimeStamp":"1647481897155",
    }

4.2返回示例

返回结果中 data 对象里的数值 : 空号, 实号, 停机, 未知, 沉默号, 风险号, 疑似空号

  
    {
      "message":"success",
      "code": 1,
      "data":"{
        "实号": ["15587571285", "15587571286"],
        "沉默号": ["15587571281", "15587571282"],
      }",
    }
  

6.错误码

参阅 API 错误代码