Production Ready GraphQL

The simplicity with which clients can consume use cases using GraphQL is often balanced by additional complexity on the server. Learn how to manage this complexity and make sure you keep providing a quality GraphQL API as your team or organization scales. Every language and every GraphQL implementation does things slightly differently. This book is completely language agnostic and instead focuses on concepts and patterns that are achievable no matter how you're building a GraphQL server. Think of it as a complete journey of what goes into building a GraphQL API, from design, to architectures, to implementation, and even documentation. Preface Acknowledgments An Introduction to GraphQL One-Size-Fits-All Let's Go Back in Time Enter GraphQL Type System Introspection Summary GraphQL Schema Design What Makes an API Great? Design First Client First Naming Descriptions Use the Schema, Luke! Expressive Schemas Specific or Generic The Relay Specification Lists & Pagination Sharing Types Global Identification Nullability Abstract Types Designing for Static Queries Mutations Fine-Grained or Coarse-Grained Errors Schema Organization Asynchronous Behavior Data-Driven Schema vs Use-Case-Driven Schema Summary Implementing GraphQL Servers GraphQL Server Basics Code First vs Schema First Generating SDL Artifacts Resolver Design Schema Metadata Multiple Schemas Modular Schemas Testing Summary Security Rate Limiting Blocking Abusive Queries Timeouts Authentication Authorization Blocking Introspection Persisted Queries Summary Performance & Monitoring Monitoring The N+1 Problem and the Dataloader Pattern Caching Compiled Queries Summary Tooling Linting Analytics Summary Workflow Design Review Development Publish Analyze Ship Public GraphQL APIs Is GraphQL a Good Choice for Public APIs Lack of Conventions With Great Power comes Great Responsibility Summary GraphQL in a Distributed Architecture GraphQL API Gateway GraphQL as a BFF Service Communication Summary Versioning API Versioning is Never Fun Versioning GraphQL is Possible Continuous Evolution Change Management Summary Documenting GraphQL APIs Documentation Generators The What, Not Just the How Workflows and Use Cases Example / Pre-Made Queries Changelogs Upcoming Changes Summary Migrating From Other API Styles Generators REST & GraphQL Alongside Summary Closing Thoughts