Hypixel

简介

Hypixel API 暴露 Hypixel Minecraft 服务器的数据——玩家、公会、空岛档案和排行榜。认证是免费 API 密钥，通过 API-Key 请求头发送（缺失密钥返回 400 “Missing API-Key header”——已实测）。

快速开始

玩家信息（替换 YOUR_KEY）：

curl "https://api.hypixel.net/v2/player?name=Hypixel" \
  -H "API-Key: YOUR_KEY"

{
  "success": true,
  "player": {
    "uuid": "f9c9c1e3-...",
    "displayname": "Hypixel",
    "networkExp": 1200000,
    "stats": { "SkyWars": {} }
  }
}

按名称查公会：

curl "https://api.hypixel.net/v2/guild?name=Hypixel" \
  -H "API-Key: YOUR_KEY"

认证方式

• 在 developer.hypixel.net 注册 → 创建应用 → API 密钥。
• 通过 API-Key 请求头携带（缺失 → 400 “Missing API-Key header”，已实测）。

速率限制与注意事项

• 免费密钥：约 60 次请求/分钟（以当前文档为准）；多数用途无需付费。
• 端点：/v2/player、/v2/guild、/v2/skyblock/profiles、/v2/leaderboards、/v2/status。
• API 覆盖 Java 版服务器（Hypixel Network）——不是其他 Minecraft 服务器。
• UUID 是稳定的玩家标识符。

常见问题

Hypixel API 免费吗？ 是的——免费密钥带每分钟限流。

如何获取密钥？ 在 developer.hypixel.net 注册 → 创建应用。

认证风格是什么？ API-Key 请求头（缺失 → 400，已实测）。