手机号标记查询

接口说明

传入手机号即可聚合查询多家主流号码标记平台的标记与认证结果，返回是否被标记、各平台状态、具体标记标签及标记量，并给出企业官方认证名称。适用于风控反欺诈、客服来电识别与电销号码过滤等场景。

调用地址

http://api.tmini.net/apis/checkmark

请求方式

GET

鉴权说明

调用本接口必须携带密钥，通过 Query 参数传递，参数名为 key。

密钥以查询参数形式拼接在调用地址之后，形如 http://api.tmini.net/apis/checkmark?key=你的密钥。缺少密钥或密钥无效时，请求无法通过校验。本接口为收费接口，调用将计入用量计费。

请求参数

请求方式为 GET，接口调用密钥通过 Query 参数 key 传递。

参数取值说明：

• key：在后台获取的调用密钥，直接拼接在请求地址的 Query 中，例如 key=后台KEY。缺少或填写错误时无法完成调用。
• phone：要查询标记情况的手机号，填写 3-11 位手机号码，例如 17264353835。请使用连续数字形式，不要包含空格、短横线或国际区号等额外字符。

成功响应示例

{
  "code": 200,
  "phone": "17264353835",
  "isMarked": true,
  "region": "重庆 移动",
  "results": [
    {
      "platform": "腾讯手机管家",
      "status": "被标记",
      "tags": [
        {
          "name": "快递送餐",
          "count": 6
        }
      ]
    },
    {
      "platform": "360手机卫士",
      "status": "被标记",
      "tags": [
        {
          "name": "快递送餐",
          "count": 13
        }
      ]
    },
    {
      "platform": "泰迪熊",
      "status": "被标记",
      "tags": [
        {
          "name": "快递外卖",
          "count": 20
        }
      ]
    },
    {
      "platform": "百事通",
      "status": "未标记"
    },
    {
      "platform": "移动",
      "status": "未标记"
    },
    {
      "platform": "电话邦",
      "status": "未标记"
    },
    {
      "platform": "小米",
      "status": "认证",
      "name": "京东快递"
    },
    {
      "platform": "搜狗",
      "status": "未标记"
    },
    {
      "platform": "联通",
      "status": "被标记",
      "tags": [
        {
          "name": "快递送餐",
          "count": 6
        }
      ]
    },
    {
      "platform": "百度",
      "status": "被标记",
      "tags": [
        {
          "name": "商业营销"
        }
      ]
    }
  ]
}

响应字段说明

错误响应示例

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

{
  "code": 0,
  "msg": "请求过于频繁（QPM 限制）",
  "errcode": 11005
}

调用成功时 code 为 200；调用失败时 code 为 0，并通过 errcode 标识具体错误类型，msg 给出可读的错误说明。

业务错误码说明

本接口为收费接口，密钥通过 Query 参数 key 传递；缺少或提供无效密钥时返回 11001、11002 或 11011，鉴权传递方式不正确时返回 11012。代理类接口同样适用 11013～11017 的错误码。

调用示例

终端 curl（bash）

curl "http://api.tmini.net/apis/checkmark?key=后台KEY&phone=17264353835"

PHP

// PHP 示例
$key = '后台KEY';
$phone = '17264353835';
$url = 'http://api.tmini.net/apis/checkmark?key=' . urlencode($key) . '&phone=' . urlencode($phone);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data && $data['code'] == 200) {
    echo '号码：' . $data['phone'] . PHP_EOL;
    echo '归属地：' . $data['region'] . PHP_EOL;
    echo '是否被标记：' . ($data['isMarked'] ? '是' : '否') . PHP_EOL;
    foreach ($data['results'] as $item) {
        $line = $item['platform'] . ' - ' . $item['status'];
        if (!empty($item['name'])) {
            $line .= '（认证名称：' . $item['name'] . '）';
        }
        if (!empty($item['tags'])) {
            $tags = [];
            foreach ($item['tags'] as $tag) {
                $tags[] = $tag['name'] . (isset($tag['count']) ? '(' . $tag['count'] . ')' : '');
            }
            $line .= ' [' . implode('、', $tags) . ']';
        }
        echo $line . PHP_EOL;
    }
} else {
    echo '查询失败' . PHP_EOL;
}

注意事项

• 密钥安全：key 通过 Query 参数传递，请在服务端调用并妥善保管，切勿硬编码到前端页面、小程序包或公开仓库中，避免泄露导致额度被盗用。密钥泄露时请及时在后台重置。
• 调用地址：请严格使用 http://api.tmini.net/apis/checkmark 原样请求，不要自行拼接或更改域名路径。
• 参数格式：phone 仅支持 11 位中国大陆手机号（如 17264353835），请勿携带 +86、空格、横线等字符；非手机号、固定号码或含字母的值将无法得到正确结果。
• 计费说明：本接口为收费接口，每次成功查询均计费，调用前请确认账户余额充足；建议在业务侧对同一号码做短时结果缓存，避免重复查询产生额外费用。
• 频率控制：请合理控制调用频率，批量号码建议串行或小并发轮询处理，并对结果做好重试与降级策略，避免瞬时请求过大触发限流。
• 字段语义：
  • isMarked 为聚合结果，任一平台标记即为 true，表示该号码存在被标记记录，不代表号码存在风险或欺诈行为。
  • results[].status 取值为「认证」「被标记」「未标记」三类；状态为「认证」时才有 name 字段（企业官方认证名称），状态为「未标记」时通常没有 tags。
  • tags[].count 为对应平台的标记量，部分平台（如百度）可能只返回标签名而不带 count，请做好空值兼容。
  • region 为号码归属地与运营商信息，可能为空字符串。
• 业务判定：标记数据来自多个平台且存在更新周期，结果仅供风控、来电识别与号码过滤参考，不建议作为唯一封禁或拒绝依据，重要决策请结合其他风控维度综合判断。