用途：为 Rails 8 应用实现带版本控制的 RESTful API，保证向后兼容与结构清晰。推荐使用 URL 路径版本化，例如 /api/v1/users。
主要能力：在 config/routes.rb 中用 namespace :api 与 namespace :v1 组织路由；按 app/controllers/api/v1 等目录分层控制器；提供 Api::BaseController 统一处理 ActiveRecord::RecordNotFound（404）、RecordInvalid（422）、ParameterMissing（400）；提供 Bearer Token 认证（读取 Authorization 头，通过 Session.find_by(token:) 定位用户，未授权返回 401）；统一响应格式：单条为 { "data": {...} }，集合为 { "data": [...], "meta": {...} }，错误为 { "error": ... }，校验错误为 { "errors": {...} }；资源控制器示例包含 index/show/create/update/destroy 与分页 meta。
使用方式：按资料中的路由、目录结构、基础控制器与资源控制器代码搭建；认证在 Api::BaseController 中通过 before_action :authenticate_api_user! 实现；测试使用 Minitest 的 ActionDispatch::IntegrationTest，覆盖 index、show、create、update、destroy 以及 404、422、401 场景，并断言响应状态与 JSON 内容。
适用场景：构建新 API、新增 API 端点、为现有 API 引入版本、需要请求测试覆盖的 Rails 项目。
限制：资料仅针对 Rails 8 与 Minitest，未提供其他框架、其他测试库、速率限制、API 文档生成或部署相关内容；具体分页依赖（如 Kaminari）与 Session 模型细节暂未提供。