In this section, we will cover how you can easily integrate a REST API into your GraphQL API.
If you want to have an outlook into the upcoming native REST integration with Hot Chocolate 13 you can head over to YouTube and have a look.
GraphQL has a strongly-typed type system and therefore also has to know the dotnet runtime types of the data it returns in advance.
The easiest way to integrate a REST API is, to define an OpenAPI specification for it. OpenAPI describes what data a REST endpoint returns. You can automatically generate a dotnet client for this API and integrate it into your schema.
OpenAPI in .NET
If you do not have an OpenAPI specification for your REST endpoint yet, you can easily add it to your API. There are two major OpenAPI implementations in dotnet: NSwag and Swashbuckle. Head over to the official ASP.NET Core documentation to see how it is done.
In this example, we will use the official example of Swashbuckle. When you start this project, you can navigate to the Swagger UI.
This REST API covers a simple Todo app.
We will expose todos
and todoById
in our GraphQL API.
Generating a client
Every REST endpoint that supports OpenAPI, can easily be wrapped with a fully typed client. Again, you have several options on how you generate your client. You can generate your client from the OpenAPI specification of your endpoint, during build or even with external tools with GUI. Have a look here and see what fits your use case the best:
In this example, we will use the NSwag dotnet tool. First, we need to create a tool manifest. Switch to your GraphQL project and execute
dotnet new tool-manifest
Then we install the NSwag tool
dotnet tool install NSwag.ConsoleCore --version 13.10.9
You then have to get the swagger.json
from your REST endpoint
curl -o swagger.json http://localhost:5000/swagger/v1/swagger.json
Now you can generate the client from the swagger.json
.
dotnet nswag swagger2csclient /input:swagger.json /classname:TodoService /namespace:TodoReader /output:TodoService.cs
The code generator generated a new file called TodoService.cs
.
In this file, you will find the client for your REST API.
The generated needs Newtonsoft.Json
.
Make sure to also add this package by executing:
dotnet add package Newtonsoft.Json
Exposing the API
You will have to register the client in the dependency injection of your GraphQL service. To expose the API you can inject the generated client into your resolvers.
// Query.cspublic class Query{ public Task<ICollection<TodoItem>> GetTodosAsync( TodoService service, CancellationToken cancellationToken) { return service.GetAllAsync(cancellationToken); }
public Task<TodoItem> GetTodoByIdAsync( TodoService service, long id, CancellationToken cancellationToken) { return service.GetByIdAsync(id, cancellationToken); }}
// Program.csbuilder.Services.AddHttpClient<TodoService>();builder.Services .AddGraphQLServer() .AddQueryType<Query>();
You can now head over to Nitro on your GraphQL Server (/graphql) and query todos
:
{ todoById(id: 1) { id isComplete name } todos { id isComplete name }}