Modrinth API 概览 —— 工具如何查询 Modrinth

这个 API 是做什么的

Modrinth 在 api.modrinth.com/v2 提供公开 REST API，让第三方工具（包括本转换器）无需抓取网页即可查询项目、列出版本并获取下载地址。

整合包工具常用的接口

GET /project/{id|slug}

返回项目元数据：标题、简介、项目类型（模组、整合包、资源包）、团队成员、许可协议。

GET /project/{id}/version

按时间倒序列出项目的所有已发布版本。每条记录都包含主文件的下载地址和 SHA-512 哈希值。

GET /version_file/{hash}?algorithm=sha512

反向查询：给定一个哈希值，找出对应的版本。用于校验转换后的 ZIP 非常方便。

速率限制

Modrinth 对匿名调用的限额相当宽松（每分钟 300 次请求）。转换器会尽可能合并请求，并遵守 Retry-After 响应头。

身份验证

大多数只读接口无需登录即可使用。需要身份验证的请求（发布、编辑）要求 Modrinth 账号令牌 —— 本转换器从不索取，因为它不会修改 Modrinth 上的任何内容。