Migrating from v1 to v2【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skillsBreaking ChangesUser Resource Changesv1:{ id: 123, name: John Doe, email: johnexample.com }v2:{ id: 123, first_name: John, last_name: Doe, email: johnexample.com }Migration:Splitnamefield intofirst_nameandlast_nameUpdate client code to use new fields提供迁移工具迁移脚本Migration scriptsSDK 更新API 差异查看器API diff viewer临时兼容层Compatibility layer版本发现Version Discovery根端点Root Endpoint通过GET /返回当前所有版本的元信息包括状态与停服时间GET / Response: { versions: { v1: { status: deprecated, sunset_date: 2025-01-15, documentation_url: https://api.example.com/docs/v1 }, v2: { status: current, documentation_url: https://api.example.com/docs/v2 }, v3: { status: beta, documentation_url: https://api.example.com/docs/v3 } } }版本状态建议采用统一枚举beta内测、current/stable当前稳定、deprecated已弃用配合sunset_date让客户端与开发者都能自主判断升级时机。版本信息端点Version Info Endpoint在每个版本内部提供自身信息GET /v2/version Response: { version: v2, released: 2024-01-15, status: stable, sunset_date: null }OpenAPI 规范中的多版本管理方案一每个版本一套独立规范openapi-v1.yaml openapi-v2.yaml openapi-v3.yaml每份规范完整、独立、可单独校验与生成 SDK。方案二单一规范 多 Servers在 OpenAPI 3.1 中通过servers数组声明多个版本地址openapi: 3.1.0 info: title: My API version: 2.0.0 servers: - url: https://api.example.com/v1 description: Version 1 (deprecated) - url: https://api.example.com/v2 description: Version 2 (current)注意OpenAPI 规范本身不区分主/次版本info.version代表的是规范描述的 API 版本可参考 openapi.md 中的 Info Object 说明因此多版本场景下更推荐方案一的一版本一文件结构确保每个版本的契约互不干扰、可独立 lint、独立发布。规范校验与验证按照 api-designer SKILL.md 的要求规范文件在交付前必须通过 lint 验证npx redocly/cli lint openapi.yaml npx stoplight/prism-cli mock openapi.yaml【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考