API 契约与工程协作
响应信封、GraphQL/REST 双栈、分层提交、RPC IDL、演示数据——协作面比代码面更常出事。
共 9 篇 · 分类建议:架构与工程效能
- 1.统一 API 响应信封:error_code、HTTP 状态码,和前后端怎么对齐
读完能定下双通道约定(协议看 HTTP、业务看信封),用 Go handler 正确回包,并让前端先判 error_code 再读 data。
November 2, 2026
- 2.GraphQL 与 REST 双栈:共享 hydrate 对齐字段,信封差别硬拧
读完能分清业务字段同源与信封差异,用共享 hydrate、信封对照表与 fixture 验收做可复述的双栈 parity。
November 4, 2026
- 3.Thrift 迁 Protobuf:IDL、生成物与传输要分轨
读完能分清契约、生成物与传输三层合同,用双协议窗口等业界切流模式做 Thrift → Protobuf / gRPC 迁移选型。
November 3, 2026
- 4.RPC 成帧别跟 IDL 捆死:Framed vs 自定义 Header vs HTTP/2
读完能分清契约、序列化与传输成帧三轨,对照裸流、Framed、自定义 Header 帧与 gRPC,并坚持双端同协议与可回滚切流。
November 4, 2026
- 5.大变更按层拆 commit:一个审查问题一层
读完能用 L0–L7 自下而上拆审查切片,在已推送与未推送历史上选型叠 PR / rebase,并拿 bisect、revert 友好当验收标准。
November 4, 2026
- 6.Demo / Mock 造数三路径:API、直写库与关系图优先
读完能按目标在 API 灌数、直写 bulk 与混合之间选型,先钉关系图再填字段,并守住 Demo 环境的 PII 红线。
November 4, 2026
- 7.后台看板:分析指标和业务名片在哪一层拼
读完能对照直连业务库、分析编排、投影缓存与 BFF 合并四种拼装层,默认用 Admin 批量 merge,并守住关联键与 N+1 预算。
November 4, 2026
- 8.头像类小图上传:代理同步还是预签名直传
读完能分清小图上传的两层合同——传输通道与对象契约——并用选型清单判断何时从应用代理同步迁到预签名直传,以及服务端必须裁定的键、校验与缓存破坏代价。
November 3, 2026
- 9.CI Webhook 投递三平面:托管 NETWORK ERROR ≠ 本端不可达
读完能分清托管出站、边缘入站与流水线消费三条平面,用模式对照在厂商 NETWORK ERROR 与本端 202 并存时做可复述的选型与手动旁路。
November 9, 2026