API Mashup: Combining APIs using GraphQL Schema Stitching

A presentation at GitHub Universe 2018 in in San Francisco, CA, USA by Rouven Weßling

In music, a mashup is a song created by blending two or more existing songs into a whole new piece. The best mashups are seamless and natural. They’re just good songs.

In today’s golden age of APIs, nobody would be surprised if you used more than six APIs in a project. But, like songs, they all work slightly differently. You also have to remember which data is located in which API and what fields indicate a foreign key to another API.

What we need are API mashups. By stitching together multiple GraphQL schemas we can take away the overhead of having to remember where data is located and how to resolve references between them. In this talk, you’ll learn how to use schema stitching to annotate the GitHub API with metadata about the repositories and users in an organization, resulting in a more powerful API that’s ready to build great tooling with less effort.