GraphQL

GraphQL – otwarty^[3] język zapytań i manipulacji danych stanowiący sposób komunikacji z serwerem za pośrednictwem API oraz środowisko wykonawcze dla wykonywania zapytań tego typu. Specyfikacja i oprogramowanie zostało opracowane przez firmę Facebook, Inc.^[4]. Jest alternatywą dla API typu REST^[5].

GraphQL

Logo programu
Autor	Facebook, Inc.
Pierwsze wydanie	11 czerwca 2018[1]
Język programowania	oficjalne implementacje m.in. w językach JavaScript, Go, Java, Kotlin, C#, Python, Rust i C/C++[2]
System operacyjny	wieloplatformowe
Strona internetowa

Język zapytań GraphQL umożliwia uzyskanie struktury odpowiedzi na żądanie na podstawie wyłącznie tych danych i parametrów, które zostały określone w strukturze zapytania, co pozwala zapobiec uzyskaniu zbędnych i nadmiarowych danych podczas takiego procesu^[6]. Wynik wykonanego zapytania jest najczęściej zwracany w postaci dokumentu w formacie JSON^[7].

Przykład

Poniższy przykład definiuje żądanie typu POST celem uzyskania podstawowych informacji o zamówieniu produktu o numerze porządkowym 10:

{
    orders(id: 10) {
        productsList {
            product {
                name
                price
            }
            quantity
        }
        totalAmount
    }
}

Zawartością odpowiedzi na wysłane żądanie będzie poniższa struktura JSON o przykładowych wartościach, stanowiąca odwzorowanie struktury powyższego żądania:

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

Zobacz też

• SQL