号码标记查询-测试测试

接口说明

本接口用于查询手机号码的标记信息，覆盖泰迪熊、360安全卫士、腾讯手机管家、百度安全卫士、联通管家、移动高频号码、电话邦、搜狗号码通等多个主流平台。

注意事项：

• 本接口为收费接口，调用将扣除账户积分。
• 每个手机号码每天仅可查询 2 次，请合理控制查询频率。
• 接口支持 GET 和 POST 两种请求方式。

调用地址

https://2.xunjinlu.fun/apis/hmbj

请求方式

• GET
• POST

鉴权方式

本接口支持以下三种鉴权方式，调用方请根据实际需求选择其中一种：

1. Query 参数：将密钥作为 key 参数附加在 URL 中。
2. Header：在请求头中添加 X-API-Key 字段，值为您的密钥。
3. Bearer Token：在请求头中添加 Authorization: Bearer <您的密钥>。

请求参数

请求示例

GET 请求示例

通过 Query 参数传递密钥：

curl -X GET "https://2.xunjinlu.fun/apis/hmbj?key=您的密钥&phoneNumber=13295744641"

通过 Header 传递密钥：

curl -X GET "https://2.xunjinlu.fun/apis/hmbj?phoneNumber=13295744641" \
-H "X-API-Key: 您的密钥"

通过 Bearer Token 传递密钥：

curl -X GET "https://2.xunjinlu.fun/apis/hmbj?phoneNumber=13295744641" \
-H "Authorization: Bearer 您的密钥"

POST 请求示例

通过 JSON Body 传递参数：

curl -X POST "https://2.xunjinlu.fun/apis/hmbj" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的密钥" \
-d '{
  "phoneNumber": "13295744641"
}'

PHP 示例

// PHP 示例
$url = 'https://2.xunjinlu.fun/apis/hmbj';
$key = '您的密钥';
$phoneNumber = '13295744641';

// 初始化 cURL
$ch = curl_init();

// 设置请求选项
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['phoneNumber' => $phoneNumber]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-Key: ' . $key
]);

// 执行请求
$response = curl_exec($ch);
curl_close($ch);

// 输出结果
echo $response;

响应参数说明

顶层响应字段

data 对象字段

platformData 数组元素字段

成功响应示例

{
  "code": 0,
  "data": {
    "phone": "13295744641",
    "platformData": [
      {
        "source": "电话邦",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "营销推广",
        "marked": true,
        "markType": "营销推广",
        "markCount": 0,
        "querySuccess": true
      },
      {
        "source": "搜狗号码通",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "无标记",
        "marked": false,
        "markType": null,
        "markCount": 0,
        "querySuccess": true
      },
      {
        "source": "移动高频号码",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "无标记",
        "marked": false,
        "markType": null,
        "markCount": 0,
        "querySuccess": true
      },
      {
        "source": "360安全卫士",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "广告推销-被12人标记",
        "marked": true,
        "markType": "广告推销",
        "markCount": 12,
        "querySuccess": true
      },
      {
        "source": "百度安全卫士",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "无标记",
        "marked": false,
        "markType": null,
        "markCount": 0,
        "querySuccess": true
      },
      {
        "source": "联通管家",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "骚扰电话-被50人标记",
        "marked": true,
        "markType": "骚扰电话",
        "markCount": 50,
        "querySuccess": true
      },
      {
        "source": "腾讯手机管家",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "商业营销或高风险电话",
        "marked": true,
        "markType": "商业营销或高风险电话",
        "markCount": 0,
        "querySuccess": true
      },
      {
        "source": "泰迪熊",
        "phoneNumber": "13295744641",
        "location": "浙江-宁波",
        "operator": "中国联通",
        "details": "您的号码用户标记次数较多。降低通话频次可有效降低用户标记，建议您10个工作日后再次尝试，谢谢",
        "marked": true,
        "markType": "您的号码用户标记次数较多。降低通话频次可有效降低用户标记，建议您10个工作日后再次尝试，谢谢",
        "markCount": 0,
        "querySuccess": true
      }
    ],
    "province": "浙江",
    "city": "宁波",
    "isp": "中国联通",
    "platformCount": 8,
    "queryId": "6b66d92a07404d1398aa1c3b596219cc",
    "queryToken": "6b66d92a07404d1398aa1c3b596219cc",
    "queryStage": null,
    "completedPlatformCount": null,
    "totalPlatformCount": null
  },
  "msg": ""
}

错误响应示例

当请求发生错误时，返回的 JSON 格式如下：

{
  "code": 0,
  "msg": "未提供密钥",
  "errcode": 11001
}

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

{
  "code": 0,
  "msg": "请求过于频繁",
  "errcode": 11005
}

业务错误码

本平台使用 errcode 字段标识具体的业务错误原因，请根据以下说明进行排查：

频率限制

• 每分钟约 2 次。
• 每个号码每天仅可查询 2 次。