DeterMination-Wind
用户用户编号 111 · 加入于 2026年9月25日
消息由 Xenon 发送
111
666
markdown 给 MDTBBS 接口维护者:启动器还需要的 API 本文给 MDTBBS / 像素工厂文件站的接口维护者。Xenon 启动器要在程序内做原生社区(版块、帖子、正文、回复),并优先从像素工厂文件站下载游戏。 依据是 2026-09-26 对公开文档和线上接口的实测: <https://mdtbbs.cn/api/v1 <https://mdtbbs.cn/api/v1/capabilities <https://mdtbbs.cn/api/v1/client/config <https://file.mdtbbs.cn/api/v1/mindustry/manifest.json 已经够用、不必重做 这些请保持稳定,启动器已经按它们接入: GET /api/v1/categories GET /api/v1/threads?page=&limit=&categoryid= GET /api/v1/threads/{id}(含 content、replies、replypagination) GET /api/v1/capabilities GET /api/v1/client/config GET /api/v1/discover、GET /api/v1/home 文件站 GET /api/v1/mindustry/manifest.json(相对 downloadurl、sha256、tag、sourcerepository) 响应继续用 { data, meta } / { error, meta }。error.code 保持稳定,不要只返回中文句子。 请新增或对桌面客户端开放 1. 桌面登录(最高优先级) 现在只有「原生第一方客户端」一条路:MindAuth authorization code + PKCE,再 POST /api/v1/auth/mobile/exchange 换成论坛 access / refresh token。GET /api/v1/capabilities 里 deviceauth 为 false。文档同时写明 External API Key 不能放进桌面客户端。 请增加一套给第三方桌面启动器的公开客户端登录,建议: 注册一个公开的 clientid(无 client secret,使用 PKCE) GET /api/v1/auth/desktop/authorize:返回验证地址和 usercode / devicecode,或标准授权码地址 POST /api/v1/auth/desktop/token:用 code + codeverifier 换 accesstoken、refreshtoken、expiresin POST /api/v1/auth/desktop/refresh POST /api/v1/auth/desktop/logout access token 仍可按现在的约 30 分钟,refresh token 轮换可以保留。登录完成后,现有的 GET /api/v1/me 就能用。 2. 注册与账号状态 公开文档里没有启动器可调用的注册接口。/me 未登录时返回 401,没有「为什么不能发帖」的字段。 请增加: POST /api/v1/auth/register:用户名、密码、验证码或邮箱。若注册必须跳到网页,请给出可在系统浏览器完成、再回到桌面 token 接口的地址,并写进文档。 扩展 GET /api/v1/me,至少包含:id、username、avatar、role、banned、phoneverified、canpost、canreply、canmessage。不能发帖时给稳定的 postblockreason(如 postingdisabled、phonerequired、banned),不要只靠中文 message。 3. 发帖、回复、编辑 GET /api/v1/client/config 当前是: json { "features": { "posting": false, "imageupload": false, "notificationssse": false } } 文档写明写操作还要登录和手机验证。External API 的 POST /api/external/v1/posts 和 POST /api/external/v1/posts/{id}/replies 只能放在服务器上。 请对已登录的桌面 token 开放第一方写接口,并在 features.posting 为 true 时生效: POST /api/v1/threads:categoryid、title、content、可选 tags POST /api/v1/threads/{id}/replies:content PATCH /api/v1/threads/{id}、PATCH /api/v1/replies/{id}:仅作者 POST /api/v1/uploads/images:配 features.imageupload 正文请同时返回 Markdown 源文 content 和现成的 contenthtml。锁帖、禁言用 error.code,例如 THREADLOCKED、POSTINGDISABLED。 4. 列表字段和搜索 GET /api/v1/threads 现在每条只有 id、title、categoryid、userid、计数和时间。卡片要显示作者和版块名,只能再请求详情。?q= 实测返回 400。meta 里没有总数,客户端无法知道还有没有下一页。 请在列表每条中直接带上: authorname、authoravatarurl categoryname、categoryslug excerpt(纯文本摘要,一两百字) ispinned、islocked、replycount、viewcount、createdat 并增加: GET /api/v1/threads?q=&categoryid=&page=&limit= meta.page、meta.limit、meta.total、meta.hasmore 详情里的 replypagination 已经有 page / limit / totalpages,请补一个明确的翻页参数:GET /api/v1/threads/{id}?replypage=&replylimit=。 5. 私信和通知 网站有 /messages、/notifications,公开 V1 文档没有对应读写信接口。notificationsv1 和 notificationssse 都是 false。 请增加: GET /api/v1/messages、GET /api/v1/messages/{id}、POST /api/v1/messages GET /api/v1/notifications、POST /api/v1/notifications/{id}/read 能力开关打开后再提供 SSE 或轮询间隔说明 未登录访问应返回 401,而不是 404。 6. 资源和文件站,供启动器安装 游戏包清单已经能用。论坛资源这边,resourceread 为 true,但 resourcefiles 和 downloadgrants 为 false。Resource V1 文档里的下载路径因此还不能当安装源。 请在开关打开后保证这些地址可用,并在清单里给出绝对地址或可解析的 downloadurl、sha256、文件大小: GET /api/v1/resources GET /api/v1/resources/{id} GET /api/v1/resources/{id}/manifest GET /api/v1/resources/{resourceId}/versions/{versionId}/files/{fileId}/download 游戏内容的 GET /api/v1/game-content/maps 和 GET /api/v1/game-content/maps/{id}/download/file 若要对启动器开放,请在 capabilities 里单独给出 mapdownload,避免和文件站游戏包混在一起。 文档和契约 /api/openapi/v1.json 的 paths 目前是空的,Reference 页也显示 0 个接口。请把上面已经存在的读接口和将要加的写接口写进 OpenAPI。Schema 里已有 CreatePostDto、CreateReplyDto、MobileExchangeDto,但没有路径,生成客户端时用不上。 另外请写明: 匿名读接口的频率上限。启动器会缓存清单和帖子列表,不会按秒轮询。 桌面客户端的 User-Agent 约定(Xenon 现在使用 Xenon-Launcher)。 features. 与 capabilities. 的关系。客户端会在开关为 false 时隐藏按钮,不再探测写接口。 建议的交付顺序 1. 桌面 PKCE 登录、刷新、/me 状态字段。 2. 打开 features.posting,提供发帖和回复。 3. 帖子列表补上作者、版块、摘要、q 和分页 meta。 4. 私信和通知。 5. 打开 resourcefiles / downloadgrants,让 Mod 和地图能按 hash 安装。