docs(api): daily audit 2026-09-08 - fix api-catalog RUM accordion & counts - #371
Open
flashduty[bot] wants to merge 1 commit into
Open
docs(api): daily audit 2026-09-08 - fix api-catalog RUM accordion & counts#371flashduty[bot] wants to merge 1 commit into
flashduty[bot] wants to merge 1 commit into
Conversation
…ounts - Commit 33d085e (remove ServiceMap) deleted the RUM <Accordion> opening tag and the preceding Monitors </Accordion>, leaving RUM's 41 rows stranded inside the Monitors accordion. Restored </Accordion> + <Accordion title="RUM"> at the Monitors/RUM boundary in both {en,zh}/openapi/api-catalog.mdx. - Corrected stale counts introduced by the ServiceMap (33d085e) and monit-agent (68d8181) removals merged after the 2026-09-07 audit: Monitors 40 -> 32 (32 paths in monitors spec), intro total 354 -> 346. - No operations added or removed -> docs.json untouched; api-reference/*.json spec files untouched (verify against live registry: 345 public rows, spec has 346 paths, lone diff = POST /monit/rule/dstypes which is carried from HEAD because monit-webapi is not on GitHub). - lint_openapi.py: OK, 12 spec files.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
api-review 每日审计 2026-09-08
对 Flashduty 公开 API OpenAPI 3.1 规格执行每日审计(等价于
/api-review --mode generate --scope all --auto)。本轮发现并修复 api-catalog.mdx 结构/计数漂移,spec 文件与 docs.json 无需改动。本 PR 0 个 operation 增加、0 个删除,仅做目录结构/计数修复(见下)。变更内容
en/openapi/api-catalog.mdx<Accordion>开合标签;Monitors 计数 40→32;intro 总数 354→346zh/openapi/api-catalog.mdx差异说明(逐条可解释)
33d085e(remove ServiceMap,2026-09-08 合入 main)在删 ServiceMap 行时误删了 RUM 的<Accordion title="RUM (41 endpoints)">开标签及前一条 Monitors</Accordion>,导致 RUM 的 41 行被吞进 Monitors accordion 内、RUM 模块在目录中消失。本次在 Monitors/RUM 边界(### Monitor utilities空表后)恢复</Accordion>+<Accordion title="RUM (41 endpoints)">。验证
parse_pgy_registry.py解析 fc-pgyapi_test.go→auth=all公开行 345 条;spec 346 条路径,唯一差异为POST /monit/rule/dstypes(属 monitors 模块,因 monit-webapi 不在 GitHub、按规则沿用 HEAD,非新漂移)。<Accordion>,开合配对opens==closes;每模块行数与标题一致(193/32/41/53/27);目录路径 0 条不在 spec 中。api-reference/*.json零 diff(git diff --stat 仅含 2 个 catalog 文件)。未解决 / 说明