接口设计
已收录文章：15篇
-
文章 · java教程 | 1个月前 | Spring Boot · Java教程 · 接口设计 · Webhook · 幂等设计 · java spring boot WebHook 回调接口 幂等 状态流转 验签本文从 Java 服务接收第三方 Webhook 的接口设计出发，说明如何定义回调目标、验签参数、幂等键、错误响应、状态流转和兼容策略，避免重复通知和伪造请求。488 收藏
-
Golang · Go教程 | 3星期前 | golang · sse · Go教程 · net/http · 接口设计 · HTTP Go SSE FLUSH 流式响应 ResponseControllerGo 的流式响应不是把多次 Write 拼起来就结束了。本文从 http.ResponseController.Flush 入手，做一个可验证的 SSE 示例，解释缓冲何时真正送达、HTTP/2 与代理会带来什么差异，以及客户端断开后如何让 goroutine 和 ticker 及时收口。463 收藏
-
列表接口从 page 改成 cursor 时，真正容易出问题的不是 SQL，而是参数语义、错误响应和旧客户端兼容。本文用 Go net/http 设计一个可灰度迁移的游标分页接口，给出返回结构、边界校验、错误码和回归检查。427 收藏
-
Go 批量 CSV 导入不能先把全文件读进内存。用 csv.Reader 逐行读取、用大小与行数预算限制请求、按批写库并回传有限的失败行，才能让大文件导入既可控又方便用户修正。407 收藏
-
Go 的传统 encoding/json 会把 nil slice 编码为 null，把已初始化的空切片编码为 []。先由接口契约决定返回形状，再在成功响应的边界归一化并用测试锁定，避免前端空列表处理出现分支。392 收藏
-
通过订单提交场景，演示 PHP 如何用 Idempotency-Key、Redis SET NX 和 MySQL 唯一索引实现接口幂等，避免重复点击、超时重试造成重复下单。378 收藏
-
库存接口最难处理的不是把数字减一，而是让调用方准确区分扣减成功、重复请求、库存不足和参数错误。本文用 Redis Lua 原子脚本统一返回码，并给出 Go 服务端的参数、错误和兼容设计。346 收藏
-
订单咨询一多，最难受的不是模型答得不通顺，而是下游拿到的字段时有时无。用 JSON Schema 约束输出、在服务端再做一次校验，并给拒答和缺字段留出口，能把自然语言解析变成可观察、可验收的业务步骤。333 收藏
-
Chrome 在 2026 年展示了 WebMCP 这一面向浏览器智能体的实验性能力。真正接入时，先把网页动作收敛成可授权、可校验、可回退的工具接口，再决定是否进入试验，而不是把现有 API 全部暴露出去。326 收藏
-
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 收藏
-
Golang · Go问答 | 1个月前 | JSON · 接口设计 · Go问答 · nil slice · Go 接口兼容 json.Marshal nil slice empty slice 数组字段回答 Go nil slice 和空 slice 在 JSON 输出上的差异，说明为什么一个是 null、一个是 []，并给出接口数组字段统一成 [] 的代码写法、回归检查和迁移清单。305 收藏
-
本文从前端调用方视角说明批量导出接口的设计取舍：为什么大文件导出不建议同步下载，如何拆成创建任务、查询状态、获取下载链接，并给出参数、错误码和兼容策略。296 收藏