接口设计
已收录文章：17篇
-
AI 接口遇到超时不能简单重复提交。本文用 OpenAI 的 X-Client-Request-Id 和 Gemini API 的指数退避建议，拆解请求标识、可重试错误、结果去重与人工复核的完整工作流。482 收藏
-
Golang · Go教程 | 2个月前 | golang · sse · Go教程 · net/http · 接口设计 · HTTP Go SSE FLUSH 流式响应 ResponseControllerGo 的流式响应不是把多次 Write 拼起来就结束了。本文从 http.ResponseController.Flush 入手，做一个可验证的 SSE 示例，解释缓冲何时真正送达、HTTP/2 与代理会带来什么差异，以及客户端断开后如何让 goroutine 和 ticker 及时收口。463 收藏
-
AI Agent 一轮工具调用可能已经改写库存、发送通知，却在最后一步返回超时。本文用订单履约场景拆开部分成功的状态记录、补偿动作和安全重试边界，给出可落地的验收清单。460 收藏
-
自定义 http.RoundTripper 做重试时，真正容易出错的不是循环次数，而是请求体能否重放、方法是否幂等以及错误如何返回。本文用一个可运行的重试 Transport 拆开这三个边界。457 收藏
-
列表接口从 page 改成 cursor 时，真正容易出问题的不是 SQL，而是参数语义、错误响应和旧客户端兼容。本文用 Go net/http 设计一个可灰度迁移的游标分页接口，给出返回结构、边界校验、错误码和回归检查。427 收藏
-
Go 批量 CSV 导入不能先把全文件读进内存。用 csv.Reader 逐行读取、用大小与行数预算限制请求、按批写库并回传有限的失败行，才能让大文件导入既可控又方便用户修正。407 收藏
-
Go 的传统 encoding/json 会把 nil slice 编码为 null，把已初始化的空切片编码为 []。先由接口契约决定返回形状，再在成功响应的边界归一化并用测试锁定，避免前端空列表处理出现分支。392 收藏
-
库存接口最难处理的不是把数字减一，而是让调用方准确区分扣减成功、重复请求、库存不足和参数错误。本文用 Redis Lua 原子脚本统一返回码，并给出 Go 服务端的参数、错误和兼容设计。346 收藏
-
订单咨询一多，最难受的不是模型答得不通顺，而是下游拿到的字段时有时无。用 JSON Schema 约束输出、在服务端再做一次校验，并给拒答和缺字段留出口，能把自然语言解析变成可观察、可验收的业务步骤。333 收藏
-
Chrome 在 2026 年展示了 WebMCP 这一面向浏览器智能体的实验性能力。真正接入时，先把网页动作收敛成可授权、可校验、可回退的工具接口，再决定是否进入试验，而不是把现有 API 全部暴露出去。326 收藏
-
Golang · Go问答 | 2个月前 | JSON · 接口设计 · Go问答 · encoding/json · encoding/json API响应 JSON序列化 time.Time omitempty Go问答 omitzeroGo 里 time.Time 是结构体零值，旧的 omitempty 不会按很多人期待的方式省略它。Go 1.24 起可用 omitzero；需要区分缺失和有值时，用 *time.Time 更清楚。315 收藏
-
Golang · Go问答 | 2个月前 | go · 文件上传 · 安全 · net/http · 接口设计 · multipart/form-data ParseMultipartForm http.MaxBytesReader Go文件上传 请求体大小限制Go 文件上传接口不能只依赖 ParseMultipartForm 的参数，否则超大请求仍可能先进入内存或临时文件。本文从 net/http 服务端入口开始，演示 MaxBytesReader、ParseMultipartForm 和文件级校验的组合边界，并给出超限回归检查。275 收藏