用途：为 Rails 项目实现带版本管理的 RESTful API 设计，保证向后兼容与结构清晰，并配套请求规格测试。
主要能力：
- 版本策略对比：URL 路径（/api/v1/users）、查询参数（?version=1）、请求头（Accept: application/vnd.api+json; version=1）及 Accept 头（application/vnd.myapp.v1+json），推荐 URL 路径方式。
- 路由与目录：在 config/routes.rb 中用 namespace :api 嵌套 namespace :v1、:v2；控制器按 app/controllers/api/v1、v2 分层，各版本有独立 base_controller。
- 基础控制器：Api::BaseController 跳过 CSRF、默认响应 JSON，并用 rescue_from 统一处理 RecordNotFound（404）、RecordInvalid（422）、ParameterMissing（400）。
- 资源控制器：index/show/create/update/destroy 示例，含分页 meta（current_page、total_pages、total_count）与强参数。
- 响应格式：单条 data、集合 data+meta、错误 error/code 或 errors 字段。
- 认证：基于 Token 的 Authorization 头校验，以及使用 jwt gem 的 JWT 解码认证。
- 测试：RSpec request spec 模板，覆盖列表、分页、详情、404、创建成功与校验失败等场景。
使用方式：按工作流清单依次定义路由、创建基础控制器与版本控制器、编写资源控制器、按需加认证、编写请求规格并记录接口。
适用场景：新建 Rails API、为现有接口增加版本、需要统一错误与响应结构、需要接口测试覆盖时。
限制：资料未提供具体 gem 依赖版本、性能数据、收费信息及与其他框架的兼容说明；示例基于 Rails 与 RSpec，需项目已具备相应环境。