迷你世界查主页

接口说明

按迷你号查询迷你世界玩家主页资料，返回昵称、等级、粉丝与作品等公开信息及所属家族概况。适合需要展示或核对玩家主页数据的开发者与站点接入方使用，免费调用，无需密钥。

调用地址

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

请求方式

GET。请求参数以查询字符串形式附加在调用地址之后，其中 uin 为必填的迷你号。

鉴权说明

本接口无需密钥，可直接发起请求，不产生费用。

请求参数

调用地址：https://mini10.top/api/profile.php　请求方式：GET　鉴权：无需密钥　计费：免费

参数取值说明：uin 为纯数字的迷你号字符串，例如 1000；传入其他格式或空值时无法定位账号。

成功响应示例

{
  "code": 0,
  "msg": "数据获取成功!",
  "avatar_url": "http://api-v2.4001314.xyz:18808/mini/res/roleicons/397.png",
  "headframe_url": "http://api-v2.4001314.xyz:18808/mnw1/headframes/1",
  "nickname": "迷你队长",
  "uin": 1000,
  "creditScore": 100,
  "level": 3,
  "developerLevel": 6,
  "friends": 3,
  "toapply": 0,
  "following": 1,
  "eachothers": 3,
  "fans": 2363793,
  "popularity": 227747192,
  "charmValue": 50512,
  "cubeValue": 1074631,
  "downloads": 225383369,
  "medalsCount": 21,
  "postsCount": 149,
  "headframesCount": 20,
  "skinsCount": 58,
  "mountsCount": 9,
  "weaponsCount": 2,
  "titlesCount": 2,
  "createdWorks": 33,
  "moodText": " ",
  "country": "中国",
  "headframeID": 1,
  "IP": "广东",
  "VIP": false,
  "vip_end_time": 1713542399,
  "online": "离线",
  "last_login_time": "2025.03.28 10:07:14",
  "regist_account_time": "2015.06.25 10:43:07",
  "thumbs_up": 17906,
  "family": {
    "code": 0,
    "msg": "家族数据获取成功!",
    "name": "粤海",
    "id": 122222,
    "desc": "迷你官方认证",
    "level": 4,
    "member_count": "194/200",
    "leader_uin": 105249910,
    "creator_uin": 1764032056,
    "create_time": "2025.01.15",
    "active_val": 8879,
    "day_active": 0,
    "last_day_active_val": 4,
    "last_week_active_val": 20,
    "server_cnt": 0,
    "map_cnt": 9,
    "header_type": 1,
    "header_url": "http://prod-env-cloud-resshop.mini1.cn/resshop/105249910/9f424a6e8dcc4ea31b491968f002d341403a388f908153c40ffc901fc9272a92/familyhead_upload_tmp1770971747.png?auth_key=8bca68d70b325f8ae12236ac81cef61e&timestamp=1770971761",
    "header_flagm_url": "http://api-v2.4001314.xyz:18808/mini/res/family/flagm/5.png"
  },
  "api_ver": "1.59.0",
  "queryTime": "0.30秒",
  "official": "请勿盗用"
}

响应字段说明

错误响应示例

当请求未能正常返回数据时，接口会在 HTTP 响应体中返回统一结构的 JSON，其中 code 固定为 0，msg 为可读的提示信息，errcode 为业务错误码。调用方应以 errcode 判断具体失败原因。

缺少必填参数或参数不合法：

{
  "code": 0,
  "msg": "迷你号不能为空",
  "errcode": 11013
}

鉴权相关失败：

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

请求处理阶段失败：

{
  "code": 0,
  "msg": "目标请求失败，请稍后重试",
  "errcode": 11016
}

服务不可用或维护中：

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

本接口无需密钥且免费，正常情况下不会返回与密钥、积分相关的错误码；若出现，通常表示调用方式与接口要求不一致，或全站级别的策略限制生效。

业务错误码说明

下表列出本接口及其所在服务可能返回的全部业务错误码。调用方应根据 errcode 字段进行分支处理，而不是仅依赖 msg 文案。

处理建议：11005 应做退避重试；11013～11017、11017 相关场景应视为服务侧或请求处理失败，可稍后重试；11001～11004、11009～11012、11019～11025 属于凭据、权限与策略类问题，重试无效，需调整调用方配置。

调用示例

终端 curl（bash）

curl "https://mini10.top/api/profile.php?uin=1000"

PHP

// PHP 示例：查询迷你号 1000 的主页信息
$url = "https://mini10.top/api/profile.php?uin=" . urlencode("1000");

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

if ($response === false) {
    echo "请求失败: " . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo $data["nickname"] . " 等级 " . $data["level"];
}

curl_close($ch);

注意事项

• 无需密钥：本接口公开调用，不需要携带任何密钥或身份参数，请勿在请求中附加来源不明的鉴权字段，以免被忽略或引发异常。虽然是免费接口，仍建议将调用逻辑收敛在服务端，避免调用地址被前端直接暴露后遭到恶意刷量。
• 参数唯一且必填：uin 为必填的迷你号字符串，需传入真实存在的迷你号（如示例中的 1000）。请勿传空值、纯空格或非数字内容；建议在发起请求前对 uin 做格式校验（非空、仅数字），降低无效查询比例。
• 数值类型差异：返回中的 uin 为数值型，而请求参数为字符串型，做本地缓存或比对时请统一类型，避免字符串与数字混用导致查不到记录。
• 成功判定：以 code 为 0 且 msg 为「数据获取成功!」作为成功依据；family 字段是嵌套结构，含有独立的 code 与 msg，即使主页数据成功，家族信息也可能为空或缺失，请分别判空后再展示。
• 字段可能与现实不符：online、last_login_time、IP、VIP、vip_end_time 等属于动态数据，moodText 可能为空白字符串，头像与头像框、家族徽章均为外部直链，可能出现加载失败，请在前端做占位与超时降级处理。
• 时间与数值格式：last_login_time、regist_account_time 为「年.月.日 时:分:秒」格式的字符串，vip_end_time 为 Unix 时间戳（秒），解析时请分别处理，不要混用同一套格式化逻辑。
• 频率控制：本接口免费且单次查询耗时约为 queryTime 所示量级（示例 0.30 秒），请勿在短时间内对同一 uin 高频轮询；建议对相同迷你号的结果做短周期缓存（如数分钟），并对批量查询做串行限速与失败重试退避控制。
• 传输安全：请通过 HTTPS 访问 https://mini10.top/api/profile.php，不要降级为 HTTP，以免返回内容在传输过程中被篡改；解析响应时按 JSON 处理，遇到非 JSON 内容（如网关错误页）应视为失败而非空数据。
• 合规使用：official 字段已注明数据请勿盗用，返回结果仅供展示查询，请勿用于批量采集、转售或伪造他人身份信息。