Tag
api-design
Published articles tagged api-design.
Evolving a GraphQL schema
GraphQL favors continuous schema evolution over versioned URLs. This chapter classifies safe and breaking changes, documents @deprecated fields and enum values, outlines a deprecation workflow, and shows deprecationReason in NestJS code-first schemas.
Schema design in GraphQL
Good GraphQL schemas mirror how clients use data, not how tables are joined. This chapter covers query-driven design, naming and nullability, Relay-style connections, mutation payloads, and modeling errors as typed results versus the top-level errors array.