Что делает интерфейсы в GraphQLInterfaceType?

В GraphQL интерфейсы служат двум целям:

1. Они гарантируют, что типы, реализующие их, также реализуют определенные поля. Например, интерфейс Node здесь имеет поле id - это означает, что любой тип, реализующий интерфейс Node, также должен иметь поле id (и этот id должен быть скаляром идентификатора, как в интерфейсе). То же самое касается аргументы для них - любые аргументы в полях в интерфейсе также должны существовать в соответствующих полях в реализующем типе.

2. Их можно использовать, когда для поля ожидается два или более типа. Поле всегда будет преобразовано в один тип или скаляр, однако, используя интерфейсы (или объединения), мы указываем в нашей схеме, что поле мог разрешается в один из набора типов.

Итак, допустим, у нас есть Node, как в вашем фрагменте, некоторые типы, которые его реализуют, и запрос, который возвращает Node:

interface Node {
  id: ID!
}

type Foo implements Node {
  id: ID!
  someFooField: String!
  someOtherFooField: Int!
}

type Bar implements Node {
  id: ID!
  someBarField: String!
  someOtherFooField: Int!
}

type Query {
  getNode(id: ID!): Node!
}

В нашем примере getNode может разрешиться либо в Foo, либо в Bar. Когда мы пишем наш запрос, мы не знаем, какой из них будет разрешен. Но поскольку мы знаем, что поле id требуется интерфейсу, мы можем написать такой запрос:

query OperationName {
  getNode(id: "SOME_ID"){
    id
  }
}

Однако, если нам нужно запросить и someBarField, мы не сможем этого сделать:

query OperationName {
  getNode(id: "SOME_ID"){
    id
    someBarField
  }
}

потому что Foo не имеет этого поля. Вместо этого мы должны использовать фрагмент, например:

query OperationName {
  getNode(id: "SOME_ID"){
    id
    ... on Bar {
      someBarField
    }
  }
}

Тогда будет возвращен someBarField, но только если поле разрешается к типу Bar. Если это Foo, будет возвращен только идентификатор. Точно так же вы можете запросить необщие поля из любого типа, реализующего один и тот же интерфейс:

query OperationName {
  getNode(id: "SOME_ID"){
    id
    ... on Bar {
      someBarField
    }
    ... on Foo {
      someFooField
    }
  }
}

И наконец, что не менее важно, следует отметить, что профсоюзы работают очень похожим образом. Однако, в отличие от интерфейсов, для объединения не определены общие поля, поэтому тип не «реализует» объединение, он просто является его частью. Это означает, что при запросе поля, которое возвращает объединение, вам всегда придется использовать фрагменты, поскольку нет общих полей для запроса.