空号检测API

收起菜单

空号检测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.请求参数

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 错误代码