GraphQL API 设计：替代 REST 的现代方案

什么是 GraphQL？

GraphQL 是一种查询语言，客户端可以精确请求需要的数据，避免过度获取或欠获取。

Schema 定义

type User {
  id: ID!
  name: String!
  email: String!
  posts: [Post!]
}

type Post {
  id: ID!
  title: String!
  content: String!
  author: User!
}

type Query {
  user(id: ID!): User
  users: [User!]!
  posts(limit: Int): [Post!]!
}

type Mutation {
  createUser(name: String!, email: String!): User
  updatePost(id: ID!, title: String): Post
}

查询示例

query {
  user(id: "123") {
    name
    email
    posts {
      title
    }
  }
}

优势对比 REST

• 按需获取数据
• 单次请求获取关联数据
• 强类型系统
• 自带文档

实现方案

• Apollo Server (Node.js)
• GraphQL Yoga
• Hasura (自动生成)

GraphQL 让 API 更灵活高效！