Skip to content

Commit

Permalink
docs: federation overview (apollographql#3205)
Browse files Browse the repository at this point in the history
On [federation overview
page](https://www.apollographql.com/docs/deploy-preview/e4ba354a8ee685ee51a883f4/graphos/schema-design/federated-schemas/federation):
- Add benefit for connecting APIs declaratively
- Prioritize connectors quickstart
- Emphasize orchestration
- Link to Odyssey connectors course

---------

Co-authored-by: Maria Elisabeth Schreiber <maria.schreiber@apollographql.com>
  • Loading branch information
shorgi and Meschreiber authored Jan 29, 2025
1 parent 29bcb09 commit a8c3fd2
Showing 1 changed file with 20 additions and 18 deletions.
38 changes: 20 additions & 18 deletions docs/source/schema-design/federated-schemas/federation.mdx
Original file line number Diff line number Diff line change
@@ -1,27 +1,19 @@
---
title: Introduction to Apollo Federation
subtitle: Learn how federation combines your GraphQL APIs into a unified supergraph
description: Learn how Apollo Federation can help you declaratively combine your services into a unified, federated GraphQL API using a microservices architecture.
subtitle: Learn how federation orchestrates your APIs into a unified supergraph
description: Learn how Apollo Federation helps you declaratively orchestrate your APIs and services into a unified, federated GraphQL API using a microservices architecture.
redirectFrom:
- /federation
---

Apollo Federation lets you declaratively combine multiple APIs into a single, federated graph. This federated graph enables clients to interact with your APIs through a single request.
Apollo Federation enables you to declaratively combine multiple APIs into a single federated GraphQL API. Federation serves as an API orchestration layer, where clients make a single GraphQL request and it coordinates multiple API calls to return a unified response.

A client makes a request to the federated GraphQL API's single entry point called the _router_. The router intelligently orchestrates and distributes the request across your APIs and returns a unified response. For a client, the request and response cycle of querying the router looks the same as querying any GraphQL server.
Clients makes requests to the federated GraphQL API's single entry point called the _router_. The router intelligently orchestrates and distributes the request across your APIs and returns a unified response. For a client, the request and response cycle of querying the router looks the same as querying any GraphQL API.

<img src='../../images/federation.svg' class="dark:hidden"/>
<img src='../../images/federation-dark.svg' class="hidden dark:block"/>

<Note>

Your federated GraphQL API, or _graph_, can be made of GraphQL APIs and other data sources.
[Learn how Apollo Connectors](../connectors/) simplify incorporating REST APIs into your graph.

</Note>


To jump into building a federated GraphQL API, check out the [Apollo GraphOS Quickstart](/graphos/get-started/guides/quickstart).
Your federated GraphQL API, or _graph_, can be made of GraphQL APIs, REST APIs, and other data sources.

<ExpansionPanel title="Watch the video overview">

Expand Down Expand Up @@ -66,6 +58,10 @@ With Apollo Federation, clients can interact with the federated schema as if it

With federation, every team contributes directly to the overall federated GraphQL schema. Each team can work independently without needing to maintain multiple API layers. This frees your platform team to focus on the quality of your API rather than keeping it up to date.

### Connect APIs declaratively

Apollo Federation is the foundation of Apollo Connectors, which allows you to integrate REST APIs into your federated graph by defining them declaratively in your GraphQL schema.

## Next steps

Before continuing, it's helpful to know some terminology:
Expand All @@ -80,12 +76,18 @@ Different subgraphs in the same supergraph can use different server implementati

Ready to get started?

- Create and run a federated graph with the [Quickstart](/graphos/get-started/guides/quickstart).

- Connect REST APIs to your graph using Apollo Connectors with the [REST quickstart](/graphos/get-started/guides/rest-quickstart).

- Create and run a federated graph with the [Quickstart](/graphos/get-started/guides/quickstart).

### Additional resources

Depending on your goals, you have several options for learning more about federation:
- If you're new to federated architecture, this [overview article](https://graphql.com/learn/federated-architecture/) can familiarize the concepts.
- If you learn best by doing, this [interactive course](https://www.apollographql.com/tutorials/voyage-part1) teaches you to build an example supergraph using Apollo Federation.
If you're new to federated architecture, this [overview article](https://graphql.com/learn/federated-architecture/) can introduce the concepts.

<OdysseyCallout>

- To integrate existing APIs into a federated graph, this [interactive course](https://www.apollographql.com/tutorials/connectors-intro-rest) teaches you how to bring an existing REST API into a GraphQL API using Apollo Connectors.

- To federate a GraphQL backend, this [interactive course](https://www.apollographql.com/tutorials/voyage-part1) teaches you how to build an example supergraph using Apollo Federation.

</OdysseyCallout>

0 comments on commit a8c3fd2

Please sign in to comment.