迷你世界账号状态查询

接口说明

用于查询指定迷你号当前是否处于封禁状态，适合需要批量核对账号可用性的开发者或运营人员使用。调用方只需提供迷你号即可获取状态结果，接口免费开放，无需密钥。

调用地址

https://api.styyds.qzz.io/apis/freezed

请求方式

GET

鉴权说明

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

请求参数

参数取值说明：

• uin 需传入纯数字形式的迷你号字符串，例如 5201314。
• 该参数为查询的唯一依据，传入后返回对应迷你号的封禁状态。
• 本接口无需密钥，可直接调用。

成功响应示例

接口调用成功后返回 JSON 格式数据，code 为 200 表示查询成功，data 中给出该迷你号的封禁状态。

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "uin": "5201314",
    "freezed": false,
    "status": "正常"
  }
}

当迷你号处于封禁状态时，返回形态如下：

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "uin": "5201314",
    "freezed": true,
    "status": "已封禁"
  }
}

响应字段说明

说明：data 中的字段以实际返回为准，若迷你号不存在或无法查询，code 与 msg 会给出对应提示，此时 data 可能为空。

错误响应示例

当请求未能正常完成时，接口统一返回如下结构的 JSON 对象，其中 code 为业务状态标识，msg 为可读的提示信息，errcode 为具体业务错误码：

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

再例如密钥校验失败时：

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

请求过于频繁时：

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

业务错误码说明

说明：本接口为免费接口，无需提供调用密钥，因此与密钥、积分相关的错误码（如 11001、11002、11003、11004、11011、11020、11023、11024）通常不会在本接口触发；当接口本身处于维护、禁用或不可用状态，或请求方式、请求地址不符合要求时，会返回对应的业务错误码。涉及代理类接口时，同样可能返回 11013～11016 以及 11017 等错误码。

调用示例

终端 curl（bash）

curl -G "https://api.styyds.qzz.io/apis/freezed" \
  --data-urlencode "uin=5201314"

PHP

// PHP
$url = "https://api.styyds.qzz.io/apis/freezed?uin=" . urlencode("5201314");

$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);

echo $response;

注意事项

• 本接口无需密钥，调用地址为 https://api.styyds.qzz.io/apis/freezed，请勿将其改写成其他域名或路径，否则请求会失败。
• 请使用 HTTPS 访问，避免在明文 HTTP 下传输迷你号等参数。
• uin 为必填参数，需以字符串形式传入，直接填写迷你号数字即可，例如 5201314；不要传入空值、空格或非数字内容，否则无法得到有效结果。
• 迷你号属于用户身份标识，请勿在公开页面、日志或截图中批量泄露他人迷你号。
• 接口免费开放，但仍请控制请求频率，避免短时间高频轮询；如遇限流请降低调用速率后重试。
• 返回结果仅反映查询时刻的账号状态，请勿将其作为长期有效的判定依据，必要时可间隔一段时间后重新查询。
• 若返回内容为空或异常，请先核对 uin 是否正确、网络是否可达，再考虑重试，避免无意义的高频请求。