SuperAPI AI 工具集

gin-api

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:用于构建生产级 Go + Gin REST API,覆盖日常最常用的模式,包括服务器搭建、路由、请求绑定、响应格式与错误处理。

主要能力:支持创建新的 Go REST API 或 HTTP 服务器;为 Gin 应用新增路由、处理器或中间件;绑定并校验 JSON、查询参数与 URI 参数;按 Clean Architecture 组织 Go 项目;在 main.go 中串联 handler→service→repository;返回一致的 JSON 错误响应。

常用方式:使用 ShouldBindJSON、ShouldBindQuery、ShouldBindURI 绑定输入;采用薄处理器模式,处理器只负责绑定、调用服务与格式化响应;通过 AppError 集中映射域错误到 HTTP 状态码;用 gin.New() 加显式中间件而非 gin.Default();Server 配置 ReadTimeout/WriteTimeout 并实现优雅关闭;将 *gin.Context 传入 goroutine 前调用 c.Copy()。

结构建议:cmd/api 放入口,internal 放 handler、service、repository、domain,pkg 放可复用中间件与工具,go.mod 管理依赖。

参考文件:routing.md 涉及路由分组、版本化、分页、通配路由、文件上传、自定义校验器与请求大小限制;middleware.md 涉及 CORS、slog 日志、限流、请求 ID、超时与恢复;error-handling.md 涉及完整 AppError 系统与校验错误格式。

限制:资料未提供具体收费、价格、平台支持与效果数据;JWT 鉴权、数据库接入、测试与部署需参考对应交叉技能。