api-endpoint

该技能面向后端 API 开发，提供构建安全、可维护 REST 接口的实践模板与代码，主要基于 Express/Node.js 与 TypeScript 生态。主要内容：其一，端点结构模板，配合路由中间件组织 authenticate、authorize、validate 与 asyncHandler；其二，输入校验使用 zod 定义 schema 并对 body、query、params 校验，另含 HTML 与文件名净化；其三，认证授权覆盖 JWT（access/refresh token、Bearer 校验、角色鉴权）与 API Key（生成、哈希存储、校验）；其四，限流使用 express-rate-limit 搭配 Redis 存储，可设置全局与敏感端点严格限制；其五，错误处理提供 ApiError 自定义错误类、统一错误中间件与 asyncHandler，能处理 Zod、Prisma 常见错误码并避免生产环境泄露细节；其六，统一响应格式与 HTTP 状态码约定，并提供分页实现；其七，安全实践包括 Helmet、CSP、CORS、参数化查询防注入、文件上传类型与大小限制；其八，日志使用 winston 与请求日志中间件。资料未提供安装命令、具体依赖版本、GraphQL 专属实现细节与官方收费信息，这些暂未提供。使用时需按项目实际环境变量与框架适配。