mini-starter/docs/architecture/api-design-integration.md

API设计和集成

API集成策略

• API集成策略: 保持现有RESTful API设计，增强OpenAPI文档
• 认证: JWT Bearer Token，保持现有认证机制
• 版本控制: 使用v1前缀 (/api/v1/)，保持向后兼容

API端点示例

用户管理端点:

• 方法: GET
• 端点: /api/v1/users
• 用途: 获取用户分页列表
• 集成: 使用通用CRUD服务，支持搜索和过滤

请求示例:

{
  "page": 1,
  "pageSize": 10,
  "keyword": "搜索词",
  "sortBy": "createdAt",
  "sortOrder": "DESC"
}

响应示例:

{
  "data": [
    {
      "id": 1,
      "email": "user@example.com",
      "roles": [{"id": 1, "name": "admin"}]
    }
  ],
  "pagination": {
    "total": 100,
    "current": 1,
    "pageSize": 10
  }
}