GraphQL

GraphQL

File:GraphQL Logo.svg
開發者	Facebook及社群
首次釋出	2015年9月14日 (2015-09-14)
目前版本	2018年6月 (2018-06)
原始碼庫	github.com/facebook/graphql
程式語言	在 JavaScript、Ruby、Scala和其他各種語言中實現。
引擎
作業系統	跨平台
特許條款
網站	graphql.org

GraphQL是一個開源的，面向API而創造出來的數據查詢操作語言以及相應的執行環境。 於2012年仍處於Facebook內部開發階段，直到2015年才公開發布。 2018年11月7日，Facebook將GraphQL專案轉移到新成立的GraphQL基金會（隸屬於非營利性的Linux基金會）。

GraphQL相較於REST以及其他web service架構提供了一種更加高效、強大和靈活的開發web APIs的方式。它通過由客戶端根據所需定義數據結構，同時由伺服器端負責返回相同數據結構的對應數據的方式避免了伺服器端大量冗餘數據的返回，但與此同時也意味着這種方式不能有效利用起查詢結果的web快取。GraphQL這種查詢語言所帶來的靈活性和豐富性的同時也增加了複雜性，導致簡單的APIs有可能並不適合這種方式。

GraphQL支援數據讀取、寫入（操作）和數據變更訂閱（即時更新）。

主要的GraphQL客戶端有Apollo Client 和 Relay. GraphQL的伺服器端在多個語言都有實現包括Haskell, JavaScript, Python, Ruby, Java, C#, Scala, Go, Elixir, Erlang, PHP, R,和 Clojure.

2018年2月9日GraphQL的部分模式定義語言（SDL）規範制定完成。

例子

POST請求：

{
    orders {
        id
        productsList {
            product {
                name
                price
            }
            quantity
        }
        totalAmount
    }
}

響應：

{
    "data": {
        "orders": [
            {
                "id": 1,
                "productsList": [
                    {
                        "product": {
                            "name": "orange",
                            "price": 1.5
                        },
                        "quantity": 100
                    }
                ],
                "totalAmount": 150
            }
        ]
    }
}

參見

• Query by Example

外部連結

• 官方網站
• List of public GraphQL APIs （頁面存檔備份，存於互聯網檔案館）