MDTBBS 开发者文档

把 MDTBBS 接入你的工具

这里整理论坛、资源中心、蓝图与地图的公开 API。先从能跑通的场景开始，再按需要接入认证、上传和同步。

论坛版本2.6.2

API 版本v1.0.0

API 地址mdtbbs.cn/api/v1

先检查服务能力

客户端启动后先请求 GET /api/v1/capabilities。如果服务端关闭某项能力，客户端应隐藏对应入口，不要靠接口报错来猜。

常见开发场景

下面的示例读取最近 10 张地图，可作为游戏内浏览器或启动器地图页的起点。

curl "https://mdtbbs.cn/api/v1/game-content/maps?sort=latest&limit=10"

公开读取接口通常可以匿名调用。需要用户身份或写权限的接口，会在指南和 API 参考中标明认证方式与 OAuth 权限范围。

指南介绍常见场景和完整流程；API 参考逐项列出参数、权限、请求体、响应和调用示例；机器可读接口定义见 /api/openapi/v1.json。

第三方客户端的稳定接口使用 /api/v1/*。管理端、服务间和未列入本开发者文档的历史路由不属于公开稳定契约。