Using GraphQL SDL files as Executable API Contracts

How GraphQL SDL files can be leveraged for Contract Testing, Mocking, and Backward Compatibility Checks to shift left the identification of contract compatibility issues — enabling alignment between frontend and backend teams without relying on integration tests.

Transcript

1. © 2025 All Rights Reserved Using GraphQL SDL files as executable API Contracts HariKrishnan83 Hari Krishnan Co-Founder and CTO
2. © 2025 All Rights Reserved Context The need for Executable API Contracts
3. © 2025 All Rights Reserved Context
4. © 2025 All Rights Reserved Building the consumer
5. © 2025 All Rights Reserved Broken Integration type Product { id: ID! name: String! inventory: Int! type: ProductType! } findAvailableProducts( type: ProductType!, pageSize: Int ): [Product] findAvailableProducts( type: ProductType!, pageSize: Int! ): [Product] type Product { id: ID! name: String inventory: String type: ProductType! }
6. © 2025 All Rights Reserved Where do we find such issues?
7. © 2025 All Rights Reserved Contract Testing Using GraphQL SDL files to generate tests #NOCODE
8. © 2025 All Rights Reserved Production Architecture
9. © 2025 All Rights Reserved Test Architecture
10. © 2025 All Rights Reserved Live Demo Generating Contract Tests from GraphQL SDL Files #NOCODE
11. © 2025 All Rights Reserved GraphQL SDL as an Executable API Contract
12. © 2025 All Rights Reserved GraphQL Mocking Starting a GraphQL Mock Server in seconds using GraphQL SDL Files #NOCODE
13. © 2025 All Rights Reserved Production Architecture
14. © 2025 All Rights Reserved Test Setup
15. © 2025 All Rights Reserved Live Demo Component Testing the Front End with Mock GraphQL Backend #NOCODE
16. © 2025 All Rights Reserved Backward Compatibility Preventing breaking changes
17. © 2025 All Rights Reserved Loop Test - Spec vs Spec (#NOCODE)
18. © 2025 All Rights Reserved Live Demo Backward Compatibility Check - Spec vs Spec Simulation #NOCODE
19. © 2025 All Rights Reserved Contract Driven Development API Governance in a Nutshell
20. © 2025 All Rights Reserved API Design First – Collaborative Effort
21. © 2025 All Rights Reserved • Shift Left all the way to Design • Reduced time-to-market due to Parallel Development • Enhanced DevEx with improved Collaboration • Resilient API Building Blocks Contract Driven Development
22. © 2025 All Rights Reserved Thank You! Hari Krishnan Co-Founder and CTO HariKrishnan83 harikrishnan83 harikrishnan83