REST API Generator 技能:按 OpenAPI 搭建可分页资源
EnglishClaude Code 安装步骤
- 从 GitHub 固定提交获取完整的 `plugins/api-development/rest-api-generator/skills/generating-rest-apis` 目录。
- 复制到目标项目的 `.claude/skills/`,确认 `.claude/skills/generating-rest-apis/SKILL.md`,再从项目根目录启动 Claude Code,输入 `/generating-rest-apis`。
中文摘要
用 Claude Code 依据本地 OpenAPI 规范搭建资源路由,验证列表分页、详情返回和无效输入。
SKILL.md 中文导读
可复现示例
向本地 books 资源放入 b1、b2、b3。请求 /books?page=2&limit=2,确认只返回 b3。请求 /books/b2 与 /books/missing,检查详情和 404。工作步骤
- 先确认 GET 列表和详情的成功、空页及资源缺失约定。为页码和每页条数设置边界。
- 按项目目录组织控制器与业务服务。测试返回顺序、分页大小和字段,再核对 OpenAPI。
验收方法
分页结果可由固定数据复算。详情与错误响应符合各自契约,项目已有测试仍通过。
GitHub 原文 · 更新日期
适用环境
准备本地 HTTP 框架、OpenAPI 定义与测试客户端。示例用内存合成图书,列表排序按稳定 ID。
常见问题
分页测试要固定排序吗?
要使用明确且稳定的排序规则。否则不同测试运行可能把记录分到不同页面。
相关指南
相关推荐
groq-install-auth 技能
jeremylongshore/claude-code-plugins-plus-skills
anima-common-errors 技能
jeremylongshore/claude-code-plugins-plus-skills
apple-notes-hello-world 技能
jeremylongshore/claude-code-plugins-plus-skills
castai-hello-world 技能
jeremylongshore/claude-code-plugins-plus-skills
cohere-local-dev-loop 技能
jeremylongshore/claude-code-plugins-plus-skills
figma-security-basics 技能
jeremylongshore/claude-code-plugins-plus-skills