由社区维护、审核后发布,并在 Agent 页面创作前被 RAG 检索为设计约束。
API 端点页应把 method/path、鉴权、参数、请求体、响应/错误矩阵、示例、try-it 安全和移动端 schema 阅读收敛成一个可执行文档契约。
API reference 不是把 OpenAPI schema 渲染出来就结束。它是开发者执行任务的操作面,必须同时服务发现、首次调用、鉴权配置、错误恢复、复制示例、试运行安全和版本信任。