迷你号状态查询

接口说明

用于查询指定迷你号是否处于封号状态，供需要核验账号可用性的调用方使用。接口为免费调用，无需密钥。

调用地址

https://mini10.top/api/freezed.php

请求方式

GET

鉴权说明

本接口无需密钥，可直接调用。

请求参数

调用地址：https://mini10.top/api/freezed.php，请求方式：GET。本接口无需密钥。

参数取值说明：

• uin 为纯数字字符串，按目标迷你号原样传入，不要添加空格或其他分隔符。
• 该参数为唯一请求参数，缺少时无法完成查询。

成功响应示例

{
  "code": "PRECHECK_ACCOUNT_IS_FREEZED",
  "msg": "迷你号已封号"
}

响应字段说明

说明：code 与 msg 一一对应，msg 用于直接向用户展示查询结论；当迷你号未被封号时，返回的 code 与 msg 会相应变为未封号状态对应的内容。

错误响应示例

当请求参数缺失、参数取值不合法或接口无法完成查询时，接口会返回统一的错误结构。错误响应的 HTTP 状态码可能随具体情况不同，但响应体始终为 JSON 对象，包含 code、msg 与 errcode 三个字段，其中 code 为固定值 0，msg 为可读的错误说明，errcode 为业务错误码。

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

参数缺失导致的错误示例：

{"code":0,"msg":"缺少必填参数 uin","errcode":11012}

密钥状态异常导致的错误示例：

{"code":0,"msg":"密钥已过期","errcode":11023}

接口暂时不可用导致的错误示例：

{"code":0,"msg":"服务暂不可用","errcode":11017}

调用方在解析响应时，应优先判断 errcode 是否存在于错误码表中：errcode 为业务错误码时表示本次调用未成功，msg 仅用于展示，不建议作为程序判断依据；code 字段不参与成功与失败的判定。本接口为免费接口，无需提供调用密钥，因此密钥类错误通常不会出现；若调用方在请求中携带了无效的鉴权信息，仍可能收到鉴权方式相关的错误。

业务错误码说明

下表列出本接口及本站接口可能返回的全部业务错误码。调用方可据此判断失败原因并决定是否重试。

补充说明：错误码 11013 至 11016 与 11017 同样适用于本站的代理类接口，用于表示接口路径不存在、目标地址无效、目标地址不被允许、请求未获得有效结果以及服务整体暂不可用等情形。参数校验类失败（例如缺少必填参数 uin、参数取值不合法）会以 11012 返回，并附带明确的 msg 提示。对于 11005、11009、11010、11017 这类与服务状态相关的错误码，建议调用方采用指数退避的方式重试；对于 11002、11003、11007、11023、11025 这类与权限和状态相关的错误码，重试通常不会改变结果，应先核查调用凭证与接口权限配置。

调用示例

终端 curl（bash）

curl -G "https://mini10.top/api/freezed.php" \
  --data-urlencode "uin=5201314"

PHP

// PHP 示例
$url = "https://mini10.top/api/freezed.php" . "?" . http_build_query([
    "uin" => "5201314"
]);

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

echo $response;

注意事项

• 迷你号准确性：uin 必须为纯数字的迷你号，以字符串形式传递。传入空值、非数字或带空格的迷你号会返回错误或查询不到结果，请在调用前对用户输入做基础校验并去除首尾空格。
• 封号状态判定：接口以返回体中的 code 字段区分状态，msg 仅作说明文案展示。请以 code 的值（如示例中的 PRECHECK_ACCOUNT_IS_FREEZED 表示已封号）作为程序判断依据，不要解析 msg 文本做逻辑处理，以免文案调整导致判断失效。
• 结果时效性：封号状态可能随账号处理进度变化，查询结果仅反映当前时刻的状态，不建议长期缓存或作为账号长期有效的唯一凭据；如需周期性监控，请自行控制轮询间隔。
• 请求方式与地址：仅支持 GET 请求，参数需通过 URL 查询字符串传递（如 ?uin=5201314）。请原样使用调用地址，不要自行拼接多余路径或改写域名。
• 传输安全：请通过 HTTPS 调用，避免在明文链路中传输参数；如需记录日志，注意不要将完整请求地址连同用户迷你号一并落库到公开可访问的位置。
• 频率与负载：本接口免费且无需密钥，请勿进行高频批量扫描或并发轰炸，避免给服务带来额外压力；建议在业务侧对同一迷你号的查询做短时间内的去重与限流。
• 参数编码：拼接查询字符串时请对 uin 做 URL 编码，防止特殊字符或空格导致请求被截断或解析异常。