apidays New York 2025 - Using GraphQL SDL files as executable API Contracts by Hari Krishnan (Specmatic)

Using GraphQL SDL files as executable API Contracts
Hari Krishnan, Co-founder & CTO at Specmatic

apidays New York 2025
API Management for Surfing the Next Innovation Waves: GenAI and Open Banking
May 14 & 15, 2025

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

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