多平台号码标记来电显示查询API接口介绍

前言

当我们接到陌生号码时，是不是担心“是不是骚扰电话”，“这个号码靠不靠谱”，“是否值得接听”。如果能提前给出标记结果，就能在很多场景下减少误接、误判与无效沟通。号码标记可帮助我们快速判断一个来电号码是否存在骚扰、营销、商业推广等标记信息。

适用场景

• 来电显示：为陌生号码增加“骚扰电话/营销推广”等标记提示
• 反骚扰与拦截：在用户接听前做风险提醒或拦截判断
• 通信风控：把号码标签接入规则引擎，用于异常识别
• 运营系统：对外呼号码或用户来电做类型归因，提高服务效率

支持平台

支持腾讯手机管家、百度手机卫士、电话邦、360手机卫士、泰迪熊等多家平台

API介绍

开发者可以通过接入号码标记API，以编程方式把号码标记能力集成到来电展示、客服、外呼、审核和风控等系统中，即可实现陌生号码识别、骚扰提醒、标签展示和风控辅助判断等功能。

相关服务可参考：多平台号码标记查询

发起查询请求

当你的业务侧拿到一个号码后，可通过发起查询接口提交任务。核心参数通常包括：

参数

参数	说明
phone	待查询号码
callbackUrl	可选，传入后支持结果回推

返回

{
  "code": 200,
  "msg": "成功",
  "taskNo": "043439882226367117195632",
  "charge": true
}

获取查询结果

如果你没有传入 callbackUrl，则可以通过查询结果接口获取最终结果。结果通常包含：

参数

参数	说明
queryTaskNo	发起查询后返回的任务号

返回

{
  "code": 200,
  "msg": "成功",
  "taskNo": "448290834186092138576138",
  "data": {
    "queryTaskNo": "043439882226367117195632",
    "count": 1,
    "results": [
      {
        "phone": "139xxxxx622",
        "status": "查询完成",
        "platform_c_name": "营销推广",
        "platform_b_name": "骚扰电话",
        "platform_d_name": "商业营销"
      }
    ]
  }
}