Articles

GraphQL 与 API 文档:gqlgen 与 swag 实践

GraphQL 与 OpenAPI(及其前身 Swagger)面向不同的 API 设计需求。选型依据可归结为三个问题:客户端有几端?数据是否关联成图、取数形状是否频繁变化?契约需要交付给外部第三方,还是仅面向内部前端?客户端形态多、数据成图、查询形状频繁变化时,GraphQL 的按需取数更有优势;面向外部消费者、优先考虑契约稳定性与工具链成熟度时,OpenAPI 是默认选择。