GraphQL：專門用來當 API 的 Query Language

GraphQL 專門拿來做 API 的 查詢語言(Query Language)

• 詳見：GraphQL | A query language for your API
• GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.

GraphQL：專門用來當 API 的 Query Language

GraphQL 從官網看到的時候，並不覺得有多麼容易懂，下述範例取自官網：

描述資料(Describe your data)

type Project {
    name: String tagline: String
    contributors: [User]
}

API 問需要的資料(Ask for what you want)

{
    project(name: "GraphQL") {
        tagline
    }
}

取得結果(Get predictable results)

{
    "project": {
        "tagline": "A query language for APIs"
    }
}

主要的優點目前在官網看到下述幾點：

• Ask for what you need, get exactly that
• Get many resources in a single request
• Evolve your API without versions
• Bring your own data and code

GraphQL 有 IDE 可以使用：graphql/graphiql: An in-browser IDE for exploring GraphQL.

研究 GraphQL 主要是因為 GitHub 最近將原本使用 REST API 轉換成 GraphQL。

註：這篇文章可以參考：GraphQL vs. REST

下述為 GitHub API 與開發相關文件

• Introduction to GraphQL - 介紹 GraphQL
• GitHub API | GitHub Developer Guide
• GraphQL API v4 Guides # 有將 REST Migrating 到 GraphQL 等連結

GitHub 全面將 API 轉換成 GraphQL 應該是有過考量，有空再來玩玩看 GraphQL。

相關網頁

• Life of a GraphQL Query — Lexing/Parsing

Save