vibe_coding/.cursor/skills/api-scaffold/references/api-response.md

API 统一响应格式

成功响应

{
  "data": { ... },
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 100,
    "totalPages": 5
  }
}

错误响应

{
  "error": "Human-readable error message",
  "code": "VALIDATION_ERROR",
  "details": [ ... ]
}

HTTP 状态码

状态码	场景
200	查询/更新成功
201	创建成功
204	删除成功（无响应体）
400	请求参数验证失败
401	未认证
403	已认证但无权限
404	资源不存在
409	资源冲突（如重复创建）
422	业务逻辑错误
429	请求频率超限
500	服务器内部错误