路径参数 | c.Param("key") | /user/:id → c.Param("id") | URL 路径中的变量 |
查询参数 | c.Query("key") | /user?id=123 | URL 查询字符串 |
查询参数(带默认值) | c.DefaultQuery("key", "default") | | 参数不存在时返回默认值 |
表单参数(POST) | c.PostForm("key") | application/x-www-form-urlencoded | 提交表单数据 |
表单参数(带默认) | c.DefaultPostForm(...) | | 同上,带默认值 |
JSON 参数 | c.BindJSON(&obj) | JSON 请求体 | application/json 请求 |
XML 参数 | c.BindXML(&obj) | XML 请求体 | application/xml |
YAML 参数 | c.BindYAML(&obj) | YAML 请求体(很少见) | application/x-yaml |
表单绑定(结构体) | c.ShouldBind(&obj) | 支持 JSON、表单等自动识别 | 结构体绑定推荐 |
Multipart 文件 | c.FormFile("file") | 文件上传 | multipart/form-data 请求 |
Header 参数 | c.GetHeader("key") | Authorization 等 | 请求头参数 |
Cookie 参数 | c.Cookie("key") | Cookie | 读取 Cookie |
路由通配符参数 | c.Param("action") in /api/*action | /api/do/something → /do/something | 路由通配符 |