0Pricing
Node.js Backend Development Bootcamp · レッスン

GraphQL API設計の原則

スキーマ、クエリ、ミューテーション、サブスクリプションなどGraphQLの基礎を学び、柔軟なAPIを設計します。

「GraphQL API設計の原則」はCoddyKit上の無料Node.js Backend Development Bootcampレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはNode.js Backend Development Bootcamp学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Node.js Backend Development Bootcampコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

What is GraphQL?

Welcome to GraphQL API Design! GraphQL is a powerful query language for your APIs and a runtime for fulfilling those queries with your existing data.

Think of it as a way for clients (like your mobile app) to ask for exactly the data they need, no more, no less. It's an alternative to traditional REST APIs.

GraphQL API設計の原則 — イラスト1

GraphQL vs. REST APIs

While REST APIs typically have multiple endpoints, each returning a fixed data structure, GraphQL uses a single endpoint.

  • REST: Often leads to over-fetching (getting more data than needed) or under-fetching (needing multiple requests for related data).
  • GraphQL: Solves this by allowing clients to specify the data shape, reducing network requests and improving efficiency.

The Core: GraphQL Schema

At the heart of every GraphQL API is its schema. The schema defines the entire API's capabilities: what data can be queried, what data can be modified, and what types of data exist.

It acts as a contract between the client and the server, ensuring both sides understand the available operations and data structures.

Schema Definition Language (SDL)

GraphQL schemas are written using the Schema Definition Language (SDL). It's a simple, intuitive language for defining types and operations.

Let's look at a basic example of defining a User type with some fields:

type User {
  id: ID!
  name: String!
  email: String
  age: Int
}

Understanding SDL Types

In the previous example:

  • type User: Defines a new object type named User.
  • id: ID!: id is a field of type ID. The ! means it's non-nullable (always present).
  • String, Int, ID: These are scalar types, GraphQL's built-in basic data types.
  • You can also define custom object types like Post or Comment.

Root Type: Query

The Query root type is special. It defines all the entry points for reading data from your API. Think of these as the 'GET' operations in REST.

Here's how you might add operations to fetch users or a single user by ID:

type Query {
  users: [User!]!
  user(id: ID!): User
}

type User {
  id: ID!
  name: String!
  email: String
  age: Int
}

Executing a GraphQL Query

Once the Query type is defined, clients can request data. They specify which fields they want from the available operations. This is how you avoid over-fetching!

To get all user names and IDs:

query GetUsers {
  users {
    id
    name
  }
}

Root Type: Mutation

The Mutation root type defines all the entry points for writing or changing data in your API. These are like 'POST', 'PUT', 'PATCH', and 'DELETE' operations in REST.

Mutations often take input arguments and return the modified object.

type Mutation {
  createUser(name: String!, email: String, age: Int): User!
  updateUser(id: ID!, name: String, email: String, age: Int): User
  deleteUser(id: ID!): Boolean!
}

Executing a GraphQL Mutation

Similar to queries, clients send mutations to perform data modifications. They specify the mutation name, its arguments, and what fields of the result they want back.

Here's an example to create a new user:

mutation CreateNewUser {
  createUser(name: "Alice", email: "alice@example.com", age: 30) {
    id
    name
    email
  }
}

Schema Design Quick Check

Consider the following GraphQL schema snippet. Which statements about it are TRUE?

type Book {
  id: ID!
  title: String!
  author: Author!
}

type Author {
  id: ID!
  name: String!
  books: [Book!]
}

type Query {
  books: [Book!]!
  book(id: ID!): Book
  authors: [Author!]!
}

type Mutation {
  createBook(title: String!, authorId: ID!): Book!
}

Recap & Beyond

Great job! You've learned the core principles of GraphQL API design:

  • GraphQL allows clients to request specific data.
  • The Schema Definition Language (SDL) defines the API's contract.
  • Object types define data structures.
  • The Query root type handles data fetching.
  • The Mutation root type handles data modification.

Next, we'll dive into building a GraphQL server with Apollo to bring these designs to life!

よくある質問

「GraphQL API設計の原則」レッスンは無料ですか？

はい。「GraphQL API設計の原則」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Node.js Backend Development Bootcampコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Node.js Backend Development Bootcampコースには全4レッスンが含まれています。

「GraphQL API設計の原則」で何を学びますか？

スキーマ、クエリ、ミューテーション、サブスクリプションなどGraphQLの基礎を学び、柔軟なAPIを設計します。 ブラウザで直接実行するハンズオンコードでNode.js Backend Development Bootcampを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Node.js Backend Development Bootcampを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのNode.js Backend Development Bootcampは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。

「GraphQL API設計の原則」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNode.js Backend Development Bootcampレッスンでコードを書いて実行できますか？

はい。すべてのNode.js Backend Development Bootcampレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. Node.jsによるサーバーレス入門
  2. GraphQL API設計の原則
  3. ApolloによるGraphQLサーバーの構築
  4. リアルタイムデータ向けGraphQLサブスクリプション
← Node.js Backend Development Bootcampに戻る