3 ways to adopt GraphQL in a REST architecture
There are three main ways to integrate with GraphQL in an existing microservices architecture:
- Build a GraphQL wrapper around REST microservices
- Build a REST wrapper around GraphQL services
REST and GraphQL APIs co-exist
Build a GraphQL wrapper around REST microservices: This is a very common technique used in enterprises that have existing downstream REST microservices. A GraphQL layer is built on top of existing REST API. Further, there’s two ways of implementing the GraphQL wrapper - 1.1 - The GraphQL layer acts as a pure orchestration layer. No business logic is added to the orchestration layer. The role of this layer is to wrap existing services and surface them as GraphQL endpoint. This layer is usually very lightweight. 1.2 - Build a GraphQL layer around new logic and existing microservices. In this technique, existing REST services are wrapped in a GraphQL resolver, and new logic is put in GraphQL layer as well. This is a very useful technique when new logic needs to be added
Build a REST wrapper around GraphQL microservices: This technique is useful when existing clients have already integrated with REST, and there is no control over these clients - meaning you can’t dictate that clients change their integration. In this method, the downstream service is a GraphQL layer where the business logic resides. A REST layer is built on top of GraphQL layer to provide compatibility to clients that have an existing integration. The benefit of this technique is that the power of GraphQL seeps through to the client without having to reintegrate. New clients can choose to integrate with GraphQL or REST.
- REST and GraphQL APIs co-exist: In this method, existing REST APIs are used in conjunction with GraphQL APIs. A good example of this is when authentication and authorization logic lives in an existing REST API that cannot be migrated easily. The client has to decide when they need to call GraphQL vs REST service.