迷你主页查询

接口说明

迷你主页查询用于按玩家迷你号获取该玩家的迷你世界主页资料，返回昵称、头像、等级、粉丝与家族等公开信息。适合需要展示玩家主页或做资料核对的场景使用，无需密钥、免费调用。

调用地址

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

请求方式

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": 2363726,
  "popularity": 227734441,
  "charmValue": 49948,
  "cubeValue": 1074631,
  "downloads": 225370685,
  "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": 17689,
  "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": 8847,
    "day_active": 10,
    "last_day_active_val": 11,
    "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×tamp=1770971761",
    "header_flagm_url": "http://api-v2.4001314.xyz:18808/mini/res/family/flagm/5.png"
  },
  "api_ver": "1.59.0",
  "queryTime": "0.33秒",
  "official": "请勿盗用"
}

响应字段说明

错误响应示例

当请求未通过校验或服务端处理失败时，接口会返回统一的 JSON 结构。其中 code 为业务状态标识，msg 为可读的提示信息，errcode 为具体错误码。以下为典型错误响应：

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

{
  "code": 0,
  "msg": "积分余额不足",
  "errcode": 11004
}

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

{
  "code": 0,
  "msg": "接口不存在",
  "errcode": 11013
}

业务错误码说明

说明：本接口为免费接口，无需密钥即可调用，通常不会触发与密钥、积分相关的错误码；当接口处于维护、禁用或***异常状态时，可能返回 11006、11007、11008、11013、11014、11015、11016、11017 等错误码。

调用示例

终端 curl（bash）

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

PHP

// PHP 示例
$url = "https://api.styyds.qzz.io/apis/profile?uin=1000";

$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 访问 https://api.styyds.qzz.io/apis/profile，不要降级为 HTTP，以免请求参数在传输过程中被篡改或窃听。
• uin 为必填参数，需传入玩家迷你号字符串，例如 1000；请勿传入空值、非数字字符或超出正常范围的编号，否则可能返回错误或空数据。
• 返回结果中的 avatar_url、headframe_url、header_url 等图片链接可能带有临时签名参数，存在有效期，请勿长期缓存或硬编码到客户端资源中。
• 返回字段较多，部分字段（如 family、vip_end_time、last_login_time）在特定账号下可能为空或缺失，调用方需做好空值判断，不要假定字段一定存在。
• 该接口为免费接口，请勿高频轮询同一 uin，建议对查询结果做合理缓存，避免对服务造成不必要的压力。
• 返回内容中的 official 字段为版权提示，请勿移除或篡改数据来源标识，也不得将查询结果用于违规用途。