路由分组的核心不是少写几个前缀,而是表达访问边界。公开接口、管理后台、内部回调,应该有不同的中间件和不同的稳定性承诺。

api := r.Group("/api/v1")
admin := r.Group("/admin/api", AdminAuth())
callback := r.Group("/callbacks", VerifySignature())

版本号建议放在对外 API 上,不一定放在后台管理接口上。后台接口通常和前端一起发布,兼容压力没那么大;开放 API 则要给调用方迁移时间。

同一个 handler 不要同时服务前台和后台。看起来复用,实际上权限、字段、审计要求都不一样。

当路由能一眼看出调用方是谁,后续加限流、审计和灰度都会轻松很多。

分类: Gin 实战 标签: Gin 路由设计 API版本

评论

-- 评论已关闭 --

全部评论