API 开发文档 - MiNi 物品ID查询

物品搜索 API GET

根据中文物品名模糊搜索物品ID，支持部分匹配，精确结果优先返回。请在当前访问域名后面带URL参数即可！

GET index.php?api=1&v={版本}&q={关键词}

参数	说明	默认
api	必填固定值 `1`	—
v	可选版本号：044 / 052 / 121	052
q	可选搜索关键词（中文物品名）	空

返回示例：

// GET ?api=1&v=121&q=木
{
  "ok": true,
  "version": "121",
  "query": "木",
  "count": 5,
  "items": [
    { "id": "200", "name": "果木" },
    { "id": "201", "name": "落叶松木" }
  ]
}

合成配方 API GET

根据物品名称或ID查询合成配方，仅支持精确匹配。返回配方所需材料列表。

GET index.php?crafting=1&v={版本}&item_name={名称} GET index.php?crafting=1&v={版本}&item_id={ID}

参数	说明	默认
crafting	必填固定值 `1`	—
v	可选版本号：044 / 052 / 121	052
item_name	必填物品中文名（与 item_id 二选一）	—
item_id	必填物品数字ID（与 item_name 二选一）	—

返回示例：

// GET ?crafting=1&v=052&item_name=果木板
{
  "ok": true,
  "recipe": {
    "recipe_id": "2",
    "name": "果木板",
    "item_id": "206",
    "count": 4,
    "materials": [
      { "id": "200", "name": "果木", "count": 1 }
    ]
  }
}

提示：item_name 和 item_id 二选一即可，优先使用 item_name。配方仅支持精确匹配（不区分大小写）。

URL 主题参数 GET

通过 URL 参数自定义页面配色和圆角，适合嵌入或定制化展示。参数生效时会隐藏配色按钮，不影响正常访问。

GET index.php?color={十六进制颜色}&radius={0-25}

参数	说明	默认
color	可选十六进制颜色代码（`#` 需编码为 `%23`）	#10b981
radius	可选卡片圆角，0-25 整数，单位 px	6

示例：

// 粉色主题 + 12px 圆角
index.php?color=%23ec4899&radius=12

// 仅修改配色
index.php?color=%233b82f6

// 仅修改圆角
index.php?radius=0

// 组合 API 查询 + 主题
index.php?api=1&v=121&q=木&color=%23ec4899

注意：# 在 URL 中必须编码为 %23。支持 3/4/6/8 位十六进制颜色值，如 %23f00、%23ff0000、%23ff000080。

错误码说明

错误码	说明
no_data_file	数据文件不存在，检查服务器文件完整性
missing_params	合成配方 API 缺少 item_name 和 item_id 参数
recipe_not_found	未找到匹配的合成配方（仅支持精确匹配）

调用示例

JavaScript Fetch：

// 搜索物品
const res = await fetch('index.php?api=1&v=121&q=木');
const data = await res.json();
console.log(data.items); // [{id:"200", name:"果木"}, ...]

// 查询合成配方
const res2 = await fetch('index.php?crafting=1&v=052&item_name=果木板');
const data2 = await res2.json();
console.log(data2.recipe.materials); // [{id:"200", name:"果木", count:1}]

cURL：

# 搜索物品
curl "index.php?api=1&v=121&q=木"

# 查询合成配方
curl "index.php?crafting=1&v=052&item_name=果木板"

# 查询物品ID + 自定义主题色
curl "index.php?api=1&v=121&q=铁&color=%233b82f6&radius=12"