Tempus ExDocumentation

FusionFeed

Authentication
Limits
Data
FQL
GraphQL
Executing Queries
Concepts
Best Practices
Gridiron Football
Association Football (Soccer)
Video
Explorer and Reference
REST

Concepts

Nodes and Edges

The FusionFeed GraphQL API design is centered around the concept of graphs. You will frequently encounter names referencing graph terminology such as "nodes" and "edges".

The term "node" is used to refer to objects in the API such as games, teams, and players.

The term "edge" is used to refer to the relationship between two nodes. For example, games often have a 1:2 relationship with teams. If drawn as a graph, that might look like this:

Now consider data points that are specific to a team within the context of a game. For example, consider the teams' scores. These team nodes may be connected to many different games, so the team's score for one game can't be placed on the team node. It would be possible to add homeTeamScore and awayTeamScore fields directly to the game itself; However, the best place for this data to live is on the game-team edge. In FusionFeed's GraphQL API, this looks like this:

query NFLGameScores($id: ID!) {
  node(id: $id) {
    ... on NFLGame {
      homeTeamEdge {
        ...gameTeamEdge
      }
      awayTeamEdge {
        ...gameTeamEdge
      }
    }
  }
}


fragment gameTeamEdge on NFLGameTeamEdge {
  score
  node {
    abbreviation
  }
}
GraphQL ExplorerOpen in GraphQL Explorer

Connections and Pagination

One-to-many relationships in FusionFeed's GraphQL API are represented as "Connections". Specifically, FusionFeed implements the Relay GraphQL Cursor Specification.

These fields can be identified by the "Connection" suffix in their name and allow for users to robustly paginate through large result sets.

For example, to enumerate NFL games, 100 games at a time, you might use a query liks this:

query EnumerateNFLGames($cursor: String) {
  nfl {
    gamesConnection(first: 100, after: $cursor) {
      edges {
        node {
          id
          time
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}
GraphQL ExplorerOpen in GraphQL Explorer
GitHubThis site is open source!

See something that could be improved? Open a pull request on GitHub.

Pull RequestContribute to This Page

On This Page

Concepts
Nodes and Edges
Connections and Pagination