文档中心
及猫云 智能融合通信一体化开放API引领者

号码服务API

作者:小编 更新时间:2025-04-30 点击数:

号码服务 API

注意:BASE_URL 联系业务经理获取。


接口安全

1.接口调用必须绑定 IP 白名单,白名单可登录 Web 端配置。
2.统一请求头(HTTP Header)
  • Content-Type: application/json
  • AppId: xxxx:开通账户后登录 Web 端可获取 AppId 和 AppKey
  • Timestamp: xxxx,时间戳,毫秒。北京时间(UTC+8),需保证服务器时间准确,允许误差 ±5 分钟。
  • Sign: xxxx,签名 md5(AppId + Timestamp + AppKey)注:前面表达式中 "+" 表示字符串拼接,不包含在 md5 内容中


防骚扰

防骚扰接口提供号码防骚扰服务,可对手机号号码进行防骚扰校验,也可对批量号码进行防骚扰校验。接口返回结果为防护等级,分为:
  • H:High,高防号码
  • M:Middle,中防号码
  • L: Low,低防号码
  • N:Normal,正常号码


防骚扰单号码校验

请求地址(HTTP URL):${BASE_URL}/app/black
请求方法(HTTP Method):GET
请求参数(Query String):mobile=1xxxxxxxxxx
返回结果(JSON 格式):
{
    "code": "200",
    "message": "success",
    "data": "N" // 参考防护等级说明
}


防骚扰批量校验

接口请求地址:${BASE_URL}/app/black_batch
请求方法:POST
请求头:Content-Type: application/json
请求参数(HTTP Body, JSON Object):
{
    "mobiles": ["1xxxxxxxxxx", "2xxxxxxxxxx"]
 }
返回结果(JSON 格式):
{
    "code": "200",
    "message": "success",
    "data": {
        "1xxxxxxxxxx": "1" // key 为号码,value 为防护等级。如果参数中有重复号码,只返回一个结果。
    }
 }


VOS 系统对接

参见VOS 系统对接说明