2
0
visuddhinanda c29e5d5c27 🚚 (api-v13): tipitaka-chapters 改名 tipitaka-titles 1 өдөр өмнө
..
README.md a45b3ed43e feat(openapi): 依据 api-v13 源码重新生成全量 API 规格 2 сар өмнө
v2-auth-current.yaml 614b5fac17 docs: v2 认证端点只剩 dashboard-v4 在用(mobile 已切 v3) 1 сар өмнө
v2-auth-forgot-password.yaml abd07a15a2 feat: 找回密码迁到 v3 password-resets,dashboard-v6 切过去 1 сар өмнө
v2-auth-reset-password-reset-password.yaml abd07a15a2 feat: 找回密码迁到 v3 password-resets,dashboard-v6 切过去 1 сар өмнө
v2-auth-reset-password.yaml abd07a15a2 feat: 找回密码迁到 v3 password-resets,dashboard-v6 切过去 1 сар өмнө
v2-case-case.yaml 8b29f9a0f8 ✨ v4 搜索页迁到 v6:搜索弹窗 + 整页 /search,词形 / 逐词 / 页码 / 补全迁 v3 1 өдөр өмнө
v2-channel-channel.yaml dfada3e379 ✨ channel 迁 v3:目录、studio 列表、我能写的、详情 / 改 / 删、阅读领域查询、batch-progress 4 өдөр өмнө
v2-channel-my-number.yaml dfada3e379 ✨ channel 迁 v3:目录、studio 列表、我能写的、详情 / 改 / 删、阅读领域查询、batch-progress 4 өдөр өмнө
v2-channel-progress.yaml dfada3e379 ✨ channel 迁 v3:目录、studio 列表、我能写的、详情 / 改 / 删、阅读领域查询、batch-progress 4 өдөр өмнө
v2-channel.yaml dfada3e379 ✨ channel 迁 v3:目录、studio 列表、我能写的、详情 / 改 / 删、阅读领域查询、batch-progress 4 өдөр өмнө
v2-chapter.yaml 9ae69a5625 chore(openapi): 重新生成规格与前端类型 1 сар өмнө
v2-discussion-discussion.yaml af76d9bd5f feat(openapi): 规格加入 /v3/discussions;v3 按路由中间件写 security 1 сар өмнө
v2-discussion.yaml af76d9bd5f feat(openapi): 规格加入 /v3/discussions;v3 按路由中间件写 security 1 сар өмнө
v2-email-certification-email-certification.yaml e16c5e55d8 feat: 注册迁到 v3(email-certifications / invites / users),dashboard-v6 切过去 1 сар өмнө
v2-email-certification.yaml e16c5e55d8 feat: 注册迁到 v3(email-certifications / invites / users),dashboard-v6 切过去 1 сар өмнө
v2-grammar-guide-grammar-guide.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-group-group.yaml 8ef4af657a ✨ 团队迁 v3:成员、角色、团队本身与团队文档;团队空间加「成员管理」 1 долоо хоног өмнө
v2-group-member-group-member.yaml 8ef4af657a ✨ 团队迁 v3:成员、角色、团队本身与团队文档;团队空间加「成员管理」 1 долоо хоног өмнө
v2-group-member.yaml 8ef4af657a ✨ 团队迁 v3:成员、角色、团队本身与团队文档;团队空间加「成员管理」 1 долоо хоног өмнө
v2-group-my-number.yaml 8ef4af657a ✨ 团队迁 v3:成员、角色、团队本身与团队文档;团队空间加「成员管理」 1 долоо хоног өмнө
v2-group.yaml 8ef4af657a ✨ 团队迁 v3:成员、角色、团队本身与团队文档;团队空间加「成员管理」 1 долоо хоног өмнө
v2-invite-invite.yaml e16c5e55d8 feat: 注册迁到 v3(email-certifications / invites / users),dashboard-v6 切过去 1 сар өмнө
v2-nissaya-card-nissaya-card.yaml fe737b657c ✨ nissaya-card 迁 v3:/v3/nissaya-cards/{ending} 3 өдөр өмнө
v2-pali-word-index.yaml 8b29f9a0f8 ✨ v4 搜索页迁到 v6:搜索弹窗 + 整页 /search,词形 / 逐词 / 页码 / 补全迁 v3 1 өдөр өмнө
v2-progress-progress.yaml 9ae69a5625 chore(openapi): 重新生成规格与前端类型 1 сар өмнө
v2-progress.yaml b9f19978a3 ✨ (tipitaka): 章节 channel 列表迁 v3(tipitaka-chapter-channels) 1 долоо хоног өмнө
v2-search-page-number-search-page-number.yaml 8b29f9a0f8 ✨ v4 搜索页迁到 v6:搜索弹窗 + 整页 /search,词形 / 逐词 / 页码 / 补全迁 v3 1 өдөр өмнө
v2-search-pali-wbw-books.yaml 8b29f9a0f8 ✨ v4 搜索页迁到 v6:搜索弹窗 + 整页 /search,词形 / 逐词 / 页码 / 补全迁 v3 1 өдөр өмнө
v2-search-pali-wbw.yaml 8b29f9a0f8 ✨ v4 搜索页迁到 v6:搜索弹窗 + 整页 /search,词形 / 逐词 / 页码 / 补全迁 v3 1 өдөр өмнө
v2-search-title-index.yaml c29e5d5c27 🚚 (api-v13): tipitaka-chapters 改名 tipitaka-titles 1 өдөр өмнө
v2-sign-in.yaml 614b5fac17 docs: v2 认证端点只剩 dashboard-v4 在用(mobile 已切 v3) 1 сар өмнө
v2-sign-up.yaml e16c5e55d8 feat: 注册迁到 v3(email-certifications / invites / users),dashboard-v6 切过去 1 сар өмнө
v2-term-vocabulary.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-terms-export-terms-export.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-terms-export.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-terms-import.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-terms-term.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v2-terms.yaml 39c3b15ee6 ✨ 术语迁 v3:terms、glossaries、导入导出、语法说明,团队空间开放术语 3 өдөр өмнө
v3-search.yaml d1721403e4 ✨ (api-v13): /v3/search 按现行 v3 规范重写 1 өдөр өмнө
v3-tipitaka-reading-channel.yaml 9ae69a5625 chore(openapi): 重新生成规格与前端类型 1 сар өмнө

README.md

手写补充

resources/auto/ 全部由 openapi/scripts/generate.php 自动生成,重跑会覆盖。

首选做法不是在这里写 YAML,而是把参数说明写进控制器的文档注释 (@queryParam / @bodyParam / @urlParam,见 openapi/README.md), 那样说明离代码最近,改接口时不容易忘记同步。

这里只放不适合写进 PHP 注释的东西:长篇示例响应、跨接口的补充说明等。 建同名文件(例如 v2-channel.yaml),内容按 OpenAPI Path Item 结构写, 生成时深度合并到自动结果之上。

合并规则:同名键以 overrides 为准,数组整体替换。所以在这里写 parameters 会覆盖掉自动生成的全部参数,通常不是你想要的。