API设计选型：REST与GraphQL的取舍

API设计选型：REST与GraphQL的取舍概览REST 强调资源与状态的标准化，GraphQL 提供灵活的查询粒度与类型系统。二者可以在系统中协同使用。技术参数（已验证）REST：天然适配 HTTP 语义与缓存（ETag、Cache-Control）；资源版本可通过 URL/头信息管理。GraphQL：单端点 + 强类型 Schema，支持按需选择字段与嵌套；需通过持久化查询与 CDN 规避缓存困难。演进：REST 易于走 CDN；GraphQL 适合 BFF 聚合与复杂页面的数据组合。实战清单内容型与公共接口优先 REST，内部复杂聚合优先 GraphQL 或 BFF。GraphQL 配合持久化查询与权限控制，避免过度自由导致滥用。