批量接口收到的 json 如果以方括号开头,也就是顶层直接是数组,goframe 能把整组数据绑定到请求结构体里的指定字段。2026 年 10 月 28 日发布的 goframe v2.10.4加入这项支持。发布日志前段还留着开发时用过的临时标签,正式版采用的写法是 body:"*"。

变化发生在请求的最外层。以往把一批记录装在对象字段里,调用方要先构造一个带字段名的外壳;使用顶层数组时,请求体本身就是列表。对接已经采用这种格式的批量接口,服务端能按原有数组格式接收,而不必因为绑定方式再要求调用方改成对象。
官方合入记录说明,整包标记只接受星号,一个请求结构只能指定一个这样的字段,字段类型必须是切片或指向切片的指针。普通结构体、固定长度数组和上传文件字段不在这一范围。发行标签里的测试将消息列表标为整包字段,同一个请求里仍有按常规方式绑定的其他字段。

发布日志开头的 in:"body" 是开发分支上短暂用过的写法,当时用来指代整个请求体,正式版发布前便已替换。整包标签不能和指定参数来源位置的 in 写在同一个字段上。接口注册和 OpenAPI 描述生成,都按最终标签处理这个字段。日志里的两种写法记录的是同一项功能的调整,并不能任选。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
完全没有请求体,和主动提交空数组,不是同一回事。发行版测试显示,空数组绑定后得到的是长度为零但非 nil 的切片;没有请求体时,字段仍是 nil 切片。同名查询参数也不能替代整包字段的请求体。依赖这项区别判断「提交空列表」还是「未提交」的服务,需要用两种输入分别验证。
新标签是按接口声明启用的。仍以 JSON 对象作为请求体的接口,继续由普通字段接收对象内容;新增数组入口也不意味着批次大小、权限或业务规则自动改变。是否调整现有调用格式,取决于已经对外公布的接口约定。
版本源码截图许可:GoFrame MIT License。
Copyright (c) 2017 GoFrame Team https://goframe.org Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.










