schema.graphql

directive @cacheControl(maxAge: Int, scope: CacheControlScope) on FIELD_DEFINITION | OBJECT | INTERFACE

enum CacheControlScope {
  PUBLIC
  PRIVATE
}

type Character {
  """The id of the character."""
  id: ID

  """The name of the character."""
  name: String

  """The status of the character ('Alive', 'Dead' or 'unknown')."""
  status: String

  """The species of the character."""
  species: String

  """The type or subspecies of the character."""
  type: String

  """
  The gender of the character ('Female', 'Male', 'Genderless' or 'unknown').
  """
  gender: String

  """The character's origin location"""
  origin: Location

  """The character's last known location"""
  location: Location

  """
  Link to the character's image.
  All images are 300x300px and most are medium shots or portraits since they are intended to be used as avatars.
  """
  image: String

  """Episodes in which this character appeared."""
  episode: [Episode]!

  """Time at which the character was created in the database."""
  created: String
}

type Characters {
  info: Info
  results: [Character]
}

type Episode {
  """The id of the episode."""
  id: ID

  """The name of the episode."""
  name: String

  """The air date of the episode."""
  air_date: String

  """The code of the episode."""
  episode: String

  """List of characters who have been seen in the episode."""
  characters: [Character]!

  """Time at which the episode was created in the database."""
  created: String
}

type Episodes {
  info: Info
  results: [Episode]
}

input FilterCharacter {
  name: String
  status: String
  species: String
  type: String
  gender: String
}

input FilterEpisode {
  name: String
  episode: String
}

input FilterLocation {
  name: String
  type: String
  dimension: String
}

type Info {
  """The length of the response."""
  count: Int

  """The amount of pages."""
  pages: Int

  """Number of the next page (if it exists)"""
  next: Int

  """Number of the previous page (if it exists)"""
  prev: Int
}

type Location {
  """The id of the location."""
  id: ID

  """The name of the location."""
  name: String

  """The type of the location."""
  type: String

  """The dimension in which the location is located."""
  dimension: String

  """List of characters who have been last seen in the location."""
  residents: [Character]!

  """Time at which the location was created in the database."""
  created: String
}

type Locations {
  info: Info
  results: [Location]
}

type Query {
  """Get a specific character by ID"""
  character(id: ID!): Character

  """Get the list of all characters"""
  characters(page: Int, filter: FilterCharacter): Characters

  """Get a list of characters selected by ids"""
  charactersByIds(ids: [ID!]!): [Character]

  """Get a specific locations by ID"""
  location(id: ID!): Location

  """Get the list of all locations"""
  locations(page: Int, filter: FilterLocation): Locations

  """Get a list of locations selected by ids"""
  locationsByIds(ids: [ID!]!): [Location]

  """Get a specific episode by ID"""
  episode(id: ID!): Episode

  """Get the list of all episodes"""
  episodes(page: Int, filter: FilterEpisode): Episodes

  """Get a list of episodes selected by ids"""
  episodesByIds(ids: [ID!]!): [Episode]
}

"""The `Upload` scalar type represents a file upload."""
scalar Upload