API指南
最近编辑:2026/5/18 13:55:49编辑:管理员摘要:“撰写 API 指南”
API 指南§
本页面记录前端数据访问层的全部公开契约:Repository 接口、TanStack Query hooks、URL 编码规约、命名空间 ID 矩阵与权限模型。
ArticleRepo 接口§
getByTitle(ns, title)— 仅读 article 元数据getWithCurrentRevision(ns, title)— 读 article + currentRevisionsave(ns, title, input)— 写入新修订rename(ns, fromTitle, newTitle)— 同命名空间内移动recentRevisions(limit?)— 最近修订流
命名空间矩阵§
MAIN=0 / Talk=1
USER=2 / User_talk=3
PROJECT=4 / Project_talk=5
TEMPLATE=10 / Template_talk=11
HELP=12 / Help_talk=13
CATEGORY=14 / Category_talk=15
权限模型§
USER(rank=1):评论 / 编辑 NONE 页
EDITOR(rank=2):上述 + 上传文件 / 移动页面 / 编辑 SEMI 保护页
MODERATOR(rank=3):上述 + 设置保护 / 回滚修订 / 隐藏修订
ADMIN(rank=4):上述 + 删页恢复 / 改用户角色 / 管理插件