Blog/系列

API 契约与工程协作

响应信封、GraphQL/REST 双栈、分层提交、RPC IDL、演示数据——协作面比代码面更常出事。

共 9 篇 · 分类建议:架构与工程效能


  1. 1.
    统一 API 响应信封:error_code、HTTP 状态码,和前后端怎么对齐

    读完能定下双通道约定(协议看 HTTP、业务看信封),用 Go handler 正确回包,并让前端先判 error_code 再读 data。

    November 2, 2026

  2. 2.
    GraphQL 与 REST 双栈:共享 hydrate 对齐字段,信封差别硬拧

    读完能分清业务字段同源与信封差异,用共享 hydrate、信封对照表与 fixture 验收做可复述的双栈 parity。

    November 4, 2026

  3. 3.
    Thrift 迁 Protobuf:IDL、生成物与传输要分轨

    读完能分清契约、生成物与传输三层合同,用双协议窗口等业界切流模式做 Thrift → Protobuf / gRPC 迁移选型。

    November 3, 2026

  4. 4.
    RPC 成帧别跟 IDL 捆死:Framed vs 自定义 Header vs HTTP/2

    读完能分清契约、序列化与传输成帧三轨,对照裸流、Framed、自定义 Header 帧与 gRPC,并坚持双端同协议与可回滚切流。

    November 4, 2026

  5. 5.
    大变更按层拆 commit:一个审查问题一层

    读完能用 L0–L7 自下而上拆审查切片,在已推送与未推送历史上选型叠 PR / rebase,并拿 bisect、revert 友好当验收标准。

    November 4, 2026

  6. 6.
    Demo / Mock 造数三路径:API、直写库与关系图优先

    读完能按目标在 API 灌数、直写 bulk 与混合之间选型,先钉关系图再填字段,并守住 Demo 环境的 PII 红线。

    November 4, 2026

  7. 7.
    后台看板:分析指标和业务名片在哪一层拼

    读完能对照直连业务库、分析编排、投影缓存与 BFF 合并四种拼装层,默认用 Admin 批量 merge,并守住关联键与 N+1 预算。

    November 4, 2026

  8. 8.
    头像类小图上传:代理同步还是预签名直传

    读完能分清小图上传的两层合同——传输通道与对象契约——并用选型清单判断何时从应用代理同步迁到预签名直传,以及服务端必须裁定的键、校验与缓存破坏代价。

    November 3, 2026

  9. 9.
    CI Webhook 投递三平面:托管 NETWORK ERROR ≠ 本端不可达

    读完能分清托管出站、边缘入站与流水线消费三条平面,用模式对照在厂商 NETWORK ERROR 与本端 202 并存时做可复述的选型与手动旁路。

    November 9, 2026