接口设计
已收录文章：15篇
-
Chrome 在 2026 年展示了 WebMCP 这一面向浏览器智能体的实验性能力。真正接入时，先把网页动作收敛成可授权、可校验、可回退的工具接口，再决定是否进入试验，而不是把现有 API 全部暴露出去。326 收藏
-
库存接口最难处理的不是把数字减一，而是让调用方准确区分扣减成功、重复请求、库存不足和参数错误。本文用 Redis Lua 原子脚本统一返回码，并给出 Go 服务端的参数、错误和兼容设计。346 收藏
-
列表接口从 page 改成 cursor 时，真正容易出问题的不是 SQL，而是参数语义、错误响应和旧客户端兼容。本文用 Go net/http 设计一个可灰度迁移的游标分页接口，给出返回结构、边界校验、错误码和回归检查。427 收藏
-
Golang · Go教程 | 3星期前 | golang · sse · Go教程 · net/http · 接口设计 · HTTP Go SSE FLUSH 流式响应 ResponseControllerGo 的流式响应不是把多次 Write 拼起来就结束了。本文从 http.ResponseController.Flush 入手，做一个可验证的 SSE 示例，解释缓冲何时真正送达、HTTP/2 与代理会带来什么差异，以及客户端断开后如何让 goroutine 和 ticker 及时收口。463 收藏
-
Golang · Go教程 | 3星期前 | golang · JSON · 故障排查 · Go教程 · 接口设计 · JSON Go 接口兼容性 DisallowUnknownFields 严格解码接口增加 json.Decoder.DisallowUnknownFields 后，旧客户端多传字段会从静默兼容变成 400。本文用一个订单接口故障复盘这个变化，说明如何定位触发条件、保留严格校验的收益，并通过灰度和版本边界避免再次误伤旧请求。174 收藏
-
Golang · Go问答 | 3星期前 | go · 文件上传 · 安全 · net/http · 接口设计 · multipart/form-data ParseMultipartForm http.MaxBytesReader Go文件上传 请求体大小限制Go 文件上传接口不能只依赖 ParseMultipartForm 的参数，否则超大请求仍可能先进入内存或临时文件。本文从 net/http 服务端入口开始，演示 MaxBytesReader、ParseMultipartForm 和文件级校验的组合边界，并给出超限回归检查。275 收藏
-
Go 批量 CSV 导入不能先把全文件读进内存。用 csv.Reader 逐行读取、用大小与行数预算限制请求、按批写库并回传有限的失败行，才能让大文件导入既可控又方便用户修正。407 收藏
-
订单咨询一多，最难受的不是模型答得不通顺，而是下游拿到的字段时有时无。用 JSON Schema 约束输出、在服务端再做一次校验，并给拒答和缺字段留出口，能把自然语言解析变成可观察、可验收的业务步骤。333 收藏
-
Go 的传统 encoding/json 会把 nil slice 编码为 null，把已初始化的空切片编码为 []。先由接口契约决定返回形状，再在成功响应的边界归一化并用测试锁定，避免前端空列表处理出现分支。392 收藏
-
Golang · Go问答 | 1个月前 | JSON · time.Time · 接口设计 · Go问答 · encoding/json · encoding/json API响应 JSON序列化 time.Time omitempty Go问答 omitzeroGo 里 time.Time 是结构体零值，旧的 omitempty 不会按很多人期待的方式省略它。Go 1.24 起可用 omitzero；需要区分缺失和有值时，用 *time.Time 更清楚。315 收藏
-
以 PHP 老接口迁移为例，把散落的 $_POST 读取改成 Request DTO、集中校验和统一错误响应，给出变更表、新写法、回归请求和分批迁移清单。199 收藏
-
文章 · java教程 | 1个月前 | Spring Boot · Java教程 · 接口设计 · Webhook · 幂等设计 · java spring boot WebHook 回调接口 幂等 状态流转 验签本文从 Java 服务接收第三方 Webhook 的接口设计出发，说明如何定义回调目标、验签参数、幂等键、错误响应、状态流转和兼容策略，避免重复通知和伪造请求。488 收藏