Skip to main content

API FAQ

HTTP vs RPC vs gRPC

  • HTTP
    • 提供标准的语义操作 - method,path,header,encoding
      • 路由通常基于 HOST+PATH
    • Proxy Server 能 Inspect 请求信息作出响应
      • 例如: 缓存 GET 响应, 增加额外日志, 增加元信息
    • 作为 WWW 的基础协议应用最广泛
    • 本身主要用于提供 Web Server - POST 请求可提供 C/S 服务
    • 协议本身灵活,除了基本约束,其他的人为规范只是形式上的
      • 例如: RESTful, JSONRPC, gRPC-Web
  • RPC
    • RPC 只是概念而不是协议
    • 提供程序语义
      • 路由通常基于 服务+方法
    • 主要用于 API 操作
      • 序列化 - 高效 - 固定编码逻辑
      • 安全 - mTLS, 默认 TLS
      • 跨语言 - DSL+生成 - 完整标准工具链
    • 不同的 RPC 协议实现都有所不同
  • gRPC
    • 主流 RPC 协议 - 基于 HTTP2
      • protobuf 序列化
      • 默认 TLS
      • 支持非常多的语言生成
    • 高级的 Proxy Server 能 Inspect 请求进行有限的处理逻辑
      • 协议转换
      • trace 信息注入
      • retry

POST vs PATCH vs PUT

  • POST - 创建
  • PATCH - 部分更新
  • PUT - 全量更新