REST & GraphQL: Adventures in schema-first API development
summary
Pyxis is a Python MongoDB service serving millions of requests per day with ~100 external and ~150 internal endpoints; it moves from duplicated OpenAPI, marshmallow and GraphQL schemas to a single central schema that a Python generator turns into OpenAPI, marshmallow validators, GraphQL SDL and DB index specs. Schema-attached directives implement auth, validation, encryption and DB ops in order. REST becomes a thin REST adapter that translates HTTP to GraphQL. Migration uses generated integration test data and a flip-the-field cutover and results in far less duplication, easier onboarding and smoother releases.
AI-written summary · about
chapters (8)
- 0:00Intro
- 0:19Agenda
- 1:23Pixes
- 6:16Schema first approach
- 12:42Documentation
- 18:23Lessons Learned
- 22:48How we build REST
- 26:03Questions
related talks
31mGraphQL: how to make clients enjoy using your API
22mWhy Migrate from REST to GraphQL?
36mGraphQL Will Do To REST What JSON Did To XML
33mGraphQL Will Do To REST What JSON Did To XML
19mThe “Food Court Menu” of APIs: A GraphQL Introduction
30mSchema Design Patterns: Leveraging Existing REST APIs for Rapid GraphQL
22mDelivering Exceptional Infrastructure as Code through REST and GraphQL
14mGraphQL Mesh – Query Anything, Run Anywhere