API 架构
基于 HTTP 的 REST 适合公开 API 和合作方 API,因为它可缓存、为业界普遍熟悉,也容易在网关处做安全防护。GraphQL 适合在关联紧密的领域模型之上、数据需求各不相同的客户端;gRPC 适合需要严格契约、流式传输和低开销的内部服务间调用。契约先行,以 OpenAPI 或 Protocol Buffers 编写,破坏性变更在 CI 中检测。
- 基于 OpenAPI 契约的 REST
- 带持久化查询与复杂度限制的 GraphQL
- gRPC 与 Protocol Buffers
- API 网关与请求路由
- 基于游标的分页
- 增量式版本演进与弃用策略
- 带签名载荷的 Webhook
