传入手机号,聚合查询腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息。返回号码是否被标记、各平台具体状态(认证/被标记/未标记)及详细的标记标签(如骚扰电话、广告推销)和对应标记量,同时展示企业官方认证名称,适用于风控反欺诈、客服来电识别与电销号码过滤。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | 后台KEY |
| phone | string | 是 | 手机号 | 02131216055 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": "后台KEY"
},
{
"name": "phone",
"type": "string",
"required": true,
"description": "手机号",
"example": "02131216055"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "手机号标记查询",
"description": "传入手机号,聚合查询腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息。返回号码是否被标记、各平台具体状态(认证\/被标记\/未标记)及详细的标记标签(如骚扰电话、广告推销)和对应标记量,同时展示企业官方认证名称,适用于风控反欺诈、客服来电识别与电销号码过滤。",
"version": "1.0.0"
},
"paths": {
"\/apis\/checkmark": {
"get": {
"summary": "手机号标记查询",
"description": "传入手机号,聚合查询腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息。返回号码是否被标记、各平台具体状态(认证\/被标记\/未标记)及详细的标记标签(如骚扰电话、广告推销)和对应标记量,同时展示企业官方认证名称,适用于风控反欺诈、客服来电识别与电销号码过滤。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "后台KEY"
},
"description": "接口调用密钥"
},
{
"name": "phone",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "02131216055"
},
"description": "手机号"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "http:\/\/api.tmini.net",
"description": "当前访问入口(http)"
}
]
}
{
"code": 200,
"phone": "110",
"isMarked": true,
"region": "全国",
"results": [
{
"platform": "腾讯手机管家",
"status": "认证",
"name": "公安报警"
},
{
"platform": "360手机卫士",
"status": "认证",
"name": "报警电话"
},
{
"platform": "泰迪熊",
"status": "认证",
"name": "报警求助电话"
},
{
"platform": "泰迪熊高频",
"status": "未标记"
},
{
"platform": "百事通",
"status": "被标记",
"name": "报警电话"
},
{
"platform": "移动",
"status": "未标记"
},
{
"platform": "电话邦",
"status": "认证",
"name": "公安报警"
},
{
"platform": "小米",
"status": "认证",
"name": "公安报警电话"
},
{
"platform": "搜狗",
"status": "被标记",
"name": "报警服务台"
},
{
"platform": "联通",
"status": "维护中"
},
{
"platform": "百度",
"status": "认证",
"name": "公安报警电话"
}
]
}
传入手机号,聚合查询腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息,返回是否被标记、各平台状态及具体标记标签与标记量,并展示企业官方认证名称。适用于风控反欺诈、客服来电识别与电销号码过滤等场景。
https://api.tmini.net/apis/checkmark
GET
本接口必须携带密钥方可调用,密钥通过 Query 参数传递,参数名为 key,直接拼接在调用地址之后。
示例:https://api.tmini.net/apis/checkmark?key=你的密钥&phone=02131216055
key 为必填项,缺失或无效将无法完成查询。本接口为收费接口,按次计费。
请求方式为 GET,密钥通过 Query 参数 key 传递。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥,在后台获取 |
| phone | string | 是 | 待查询的手机号,可为 11 位手机号或带区号的固定电话号码 |
参数取值说明
phone:仅需传入号码本身,无需添加国家码、空格或连字符,例如 13800138000、02131216055。{
"code": 200,
"phone": "02131216055",
"isMarked": true,
"region": "上海",
"results": [
{
"platform": "腾讯手机管家",
"status": "未标记"
},
{
"platform": "360手机卫士",
"status": "未标记"
},
{
"platform": "泰迪熊",
"status": "被标记",
"tags": [
{
"name": "骚扰电话",
"count": 19
}
]
},
{
"platform": "泰迪熊高频",
"status": "被标记",
"tags": [
{
"name": "该号码为泰迪熊高频号码"
}
]
},
{
"platform": "百事通",
"status": "未标记"
},
{
"platform": "移动",
"status": "未标记"
},
{
"platform": "电话邦",
"status": "被标记",
"tags": [
{
"name": "营销推广",
"count": 184
}
]
},
{
"platform": "小米",
"status": "未标记"
},
{
"platform": "搜狗",
"status": "未标记"
},
{
"platform": "联通",
"status": "非联通"
},
{
"platform": "百度",
"status": "被标记",
"tags": [
{
"name": "广告营销"
}
]
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,200 表示查询成功 |
| phone | string | 本次查询的号码 |
| isMarked | boolean | 该号码是否在任一平台被标记,true 表示存在标记 |
| region | string | 号码归属地 |
| results | array | 各平台查询结果列表 |
| results[].platform | string | 平台名称,如腾讯手机管家、360手机卫士、百度、小米、电话邦等 |
| results[].status | string | 该平台上的号码状态,取值为 认证、被标记、未标记(部分平台可能返回如 非联通 等归属状态) |
| results[].tags | array | 标记标签列表,仅当 status 为 被标记 时返回 |
| results[].tags[].name | string | 标记标签名称,如骚扰电话、广告推销、营销推广、广告营销等 |
| results[].tags[].count | integer | 该标签的标记量,部分标签无统计数据时不返回此字段 |
| certName | string | 企业官方认证名称,号码存在官方认证时返回 |
说明:
status 为「认证」时,表示该号码在对应平台已通过企业官方认证,可结合 certName 获取认证名称。tags 中的 count 表示该标记标签的标记人数或标记量,数值越大说明标记该标签的用户越多,可用于风险权重评估。platform 与 status,不携带 tags 字段。调用失败时返回结构统一如下(code 为 0 表示本次调用未成功,errcode 为具体业务错误码,msg 为错误描述):
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
{
"code": 0,
"msg": "积分余额不足",
"errcode": 11004
}
{
"code": 0,
"msg": "请求过于频繁(QPM 限制)",
"errcode": 11005
}
{
"code": 0,
"msg": "收费接口须提供有效密钥",
"errcode": 11011
}
密钥通过 Query 参数 key 传递,例如 https://api.tmini.net/apis/checkmark?key=后台KEY&phone=02131216055。
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | 外部请求地址无效 |
| 11015 | 外部请求地址不允许 |
| 11016 | 外部请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前 IP 不在白名单内 |
| 11020 | 启用出口转发须提供有效密钥 |
| 11021 | 未配置可用出口转发通道 |
| 11022 | 出口转发通道不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
说明:11001、11002、11003、11011、11023、11024 与密钥有效性或额度相关,请核对 key 参数与余额后重试;11004、11005 为调用额度与频次限制,请充值或降低调用频率;11006、11007、11008、11013、11018 表示接口本身状态或调用方式有误,请确认请求路径与 GET 方式;11009、11010、11017 为临时性服务不可用,请稍后重试;11012、11019 为鉴权与访问范围校验未通过,请使用 Query 传入 key 并确认来源 IP 已在白名单内;11014、11015、11016 表示外部请求条件不满足或请求未成功,请检查参数与目标号码后重试;11020、11021、11022 与出口转发能力的配置状态有关。
curl "https://api.tmini.net/apis/checkmark?key=你的密钥&phone=02131216055"
// PHP
$url = 'https://api.tmini.net/apis/checkmark?' . http_build_query([
'key' => '你的密钥',
'phone' => '02131216055',
]);
$response = file_get_contents($url);
$data = json_decode($response, true);
if ($data['code'] === 200) {
echo '号码:' . $data['phone'] . PHP_EOL;
echo '归属地:' . $data['region'] . PHP_EOL;
echo '是否被标记:' . ($data['isMarked'] ? '是' : '否') . PHP_EOL;
foreach ($data['results'] as $item) {
echo $item['platform'] . ' - ' . $item['status'] . PHP_EOL;
if (!empty($item['tags'])) {
foreach ($item['tags'] as $tag) {
$count = isset($tag['count']) ? '(标记量 ' . $tag['count'] . ')' : '';
echo ' 标签:' . $tag['name'] . $count . PHP_EOL;
}
}
}
}
key 传入密钥,例如 https://api.tmini.net/apis/checkmark?key=你的密钥&phone=13800138000。密钥仅在服务端使用,严禁写入前端页面、客户端代码、公开代码仓库或日志,避免泄露后被他人盗刷额度。如怀疑泄露,请立即在后台重置密钥。https:// 协议调用,避免密钥与查询号码在传输过程中被截获。phone 传纯数字号码即可,示例 02131216055 为带区号的固定电话,说明本接口不限于手机号;请勿附加 +86、空格、横线等非数字字符,否则可能查询失败或结果不准确。results 为多个平台的聚合结果,status 反映该平台的当前状态(如已认证、被标记、未标记、非本网等),部分平台可能不提供标记量,此时 tags 中仅有 name 而无 count,属正常情况。isMarked 为整体汇总结论,只要任一平台存在标记即为 true。code 判断请求是否成功(200 表示成功),业务逻辑应优先判断该字段再读取 results 明细。curl "http://api.tmini.net/apis/checkmark?key=YOUR_API_KEY&phone=17264353835"