From e8bcd18c76d6ce0aa3d2cba1789c9bc81009d428 Mon Sep 17 00:00:00 2001
From: CPTProgrammer <46586216+CPTProgrammer@users.noreply.github.com>
Date: Sat, 11 Jul 2026 08:55:02 +0800
Subject: [PATCH] Add docs for CurseForge Meta API endpoints

---
 docs/curseforge/get-meta.md | 74 +++++++++++++++++++++++++++++++++++++
 docs/index.md               |  1 +
 2 files changed, 75 insertions(+)
 create mode 100644 docs/curseforge/get-meta.md

diff --git a/docs/curseforge/get-meta.md b/docs/curseforge/get-meta.md
new file mode 100644
index 0000000..a80bb89
--- /dev/null
+++ b/docs/curseforge/get-meta.md
@@ -0,0 +1,74 @@
+# CurseForge Meta API
+
+> 来源：https://docs.curseforge.com/rest-api/
+>
+> API 基础地址：`https://api.curseforge.com`，认证方式：Header `x-api-key: <token>`
+
+---
+
+## Get Minecraft Versions
+
+```
+GET https://api.curseforge.com/v1/minecraft/version
+```
+
+获取 CurseForge 支持的 Minecraft 版本列表，每条记录包含版本号、下载地址、审核状态等信息。
+
+### 参数
+
+无需参数。
+
+### 成功响应
+
+```jsonc
+{
+  "data": [
+    {
+      "id": 1,                                // 版本记录 ID
+      "gameVersionId": 123,                   // Game Version ID
+      "versionString": "1.21.5",              // 版本号字符串
+      "jarDownloadUrl": "https://...",        // JAR 文件下载地址
+      "jsonDownloadUrl": "https://...",       // JSON 文件下载地址
+      "approved": true,                       // 是否已审核通过
+      "dateModified": "2025-01-01T00:00:00Z", // 最后修改时间（ISO 8601）
+      "gameVersionTypeId": 1,                 // Game Version Type ID
+      "gameVersionStatus": 1,                 // 版本状态（见附表）
+      "gameVersionTypeStatus": 1              // 版本类型状态（见附表）
+    }
+  ]
+}
+```
+
+### 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | int32 | 版本记录 ID |
+| `gameVersionId` | int32 | Game Version ID |
+| `versionString` | string | 版本号字符串（如 `"1.21.5"`） |
+| `jarDownloadUrl` | string | JAR 文件下载地址 |
+| `jsonDownloadUrl` | string | JSON 文件下载地址 |
+| `approved` | boolean | 是否已审核通过 |
+| `dateModified` | string (date-time) | 最后修改时间（ISO 8601） |
+| `gameVersionTypeId` | int32 | Game Version Type ID |
+| `gameVersionStatus` | GameVersionStatus | 版本状态（见附表） |
+| `gameVersionTypeStatus` | GameVersionTypeStatus | 版本类型状态（见附表） |
+
+---
+
+## 附表
+
+### GameVersionStatus
+
+| 值 | 含义 |
+|----|------|
+| 1 | Approved — 已审核通过 |
+| 2 | Deleted — 已删除 |
+| 3 | New — 新增 |
+
+### GameVersionTypeStatus
+
+| 值 | 含义 |
+|----|------|
+| 1 | Normal — 正常 |
+| 2 | Deleted — 已删除 |
diff --git a/docs/index.md b/docs/index.md
index b09a60f..0d4e6db 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -103,6 +103,7 @@ src/types/
 |------|------|
 | `upload.md` | 上传文件 API（含 Game Version Types / Game Versions 查询） |
 | `get.md` | 获取文件列表 API（`GET /mods/{modId}/files`） |
+| `get-meta.md` | 元数据查询 API（获取 Minecraft 版本列表等） |
 
 ### 前端框架与组件库