接入指南

发布记录与联合筛选

根据同一条发布记录同时匹配加载器与游戏版本。

筛选资源时,loader 与 mc 必须在同一条发布记录上同时满足。例如记录 A 支持 Quilt 与 MC 26.2,记录 B 支持 MC 1.19.4 但不支持 Quilt,那么 loader=quilt&mc=1.19.4 没有可用构建。把两条记录分别命中后合并,会给用户错误的下载结果。

curl 'http://127.0.0.1:4520/v1/site/resources?loader=fabric&mc=1.20.1'

同一筛选维度多选是“或”,跨维度是“且”;加载器、版本与由加载器推导的类型必须在同一条发布记录上判断。开放标签属于资源本身。详情页查询也可带上筛选条件,显示匹配的发布;匹配数为零时,应明确告诉用户当前组合没有可用构建。

筛选值及其 URL 参数以接口返回的分面 queryKey 为准。加载器族仅用于详情展示分组,不参与筛选。更多参数见公开内容 API。