REST/OpenAPI

REST is the most commonly used style to build public APIs. With WunderGraph, you're able to turn any REST API specified by an OpenAPI Specification into a GraphQL API. This way, you can treat it like any other GraphQL API and even stitch it together with other APIs.

To add a REST data source, edit .wundergraph/wundergraph.config.ts and introspect the API like the config below.

import { configureWunderGraphApplication, introspect } from '@wundergraph/sdk';

const jsp = introspect.openApi({
  apiNamespace: 'jsp',
  source: {
    kind: 'file',
    filePath: '../countries.json', // this is the OpenAPI specification.
  },
});

configureWunderGraphApplication({
  apis: [jsp],
});

The REST data source is now added to your virtual graph and you can now write operations against it.

Create a new file Countries.graphql in the operations folder and add the following content:

query {
  jsp_countries {
    name
  }
}

Queries are simply HTTP endpoints on your WunderGraph server.

npm run start

curl http://localhost:9991/operations/Countries