中台/文档中心

文档中心 规范与接口文档 · 真源

数据源 /api/zt/docs/versions(权威版)+ /api/zt/docs/api-full.json(接口索引)+ /api/zt/norms/list(规范目录)· 原文 权威版 /app/docs/<file>、规范目录 /app/docs/files/<file>
页型 文档权威版 —接口 —规范目录 —时间 —
A1身份区
中台 · 文档中心(FE 域维护)
A3版本区
tokens v1.1.0 · API —
B1分类区
三类真源不许混读:权威版只认 versions 返回,接口索引只认 api-full.json,规范目录只认 norms/list。
B2列表主区
加载骨架 · 拉取 /api/zt/docs/versions
B3统计区
—权威版主题
—接口总数
—接口分组
—规范目录条目
版本规则只认最新版
归档情况—
C1来源区
/api/zt/docs/versions · —
规范目录 —
C2下钻区
点主题行 = 本区直接取原文预览(权威版取 /app/docs/<file>、规范目录取 /app/docs/files/<file>)|接口行 = 本区展示该条 method/path/分组/说明,另有直链 /api/zt/docs/api-full.json 取完整索引(原 /app/docs/api-full.json 静态不存在,废弃)|可再回本页
C3帮助区
读前先查最新版:GET /api/zt/docs/latest;空/错态均给动作,不留死链
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
字段口径 · 一列一义

主题=topic(权威版文档名);版本=version(V1/V2/…,文件名带版本号);文件=file(磁盘文件名,可直接取原文);大小=size(字节);归档=history.length(_archive/ 内旧版数量);接口行:方法=method、路径=path、分组=group、说明=desc。

接口清单 · 调用方式

/api/zt/docs/versions · 权威版清单(GET,含 topic/version/file/size/at/history)|/api/zt/docs/api-full.json · 接口索引(GET,509 条带 method/path/group/desc)|/api/zt/norms/list · 规范目录(GET,返回实际扫描目录 dir 与条目)|/api/zt/docs/latest?topic= · 单主题最新版(GET)|/api/zt/ui/version · 版本徽标(GET)|/api/zt/time/now · 北京时间(GET)

只认最新版 · 版本规则

每个主题只保留 1 份权威版;任何修改 = 版本号 +1;旧版归档 _archive/;文件名必须带版本号;文内必须有变更记录;变更后必须广播(type=规约)。

三态触发 · 何时出现

加载态:接口未返回或不足 300ms(骨架屏≥300ms);空态:搜索/分类无命中,给原因 +「看全部」动作;错误态:fetch 失败显示「—」+ 重试,不显示假数据。

操作手册 · 三步走

① 看「权威版规范」确认要用的主题当前是 V 几;② 点主题行取 .md 原文,不用旧版;③ 找接口时切「接口文档」,按分组或路径搜索,命中后直接复制 path 调。

验收口径 · 本页 DoD

P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5(本页 5 路 fetch);P8 details≥6;P9 card≥6(9 个分区全打 card);P4/P5 @media 1024 与 520 两段;tokens?v=1.1.0 且 meta dt-tokens=1.1.0;body 不裁切(无 overflow 隐藏);字号 11/13/16/20/26 五级;间距 8 倍数;行高 1.6(标题 1.25)。

数据 /api/zt/docs/versions + api-full.json + norms/list原文 /app/docs/<file> 与 /app/docs/files/<file>← 返回 中台首页—