Mis on GraphQL?

GraphQL — see on päringukeel API jaoks ja täitmise keskkond nende päringute täitmiseks teie andmetele. See pakub alternatiivi REST-ile, võimaldades kliendil küsida ainult vajalikke andmeid ühes päringus:

Peamised kontseptsioonid:

1. Skeem: Määratleb API-s saadaval olevad andmetüübid, nende seosed ja saadaval olevad toimingud (päringud, mutatsioonid, tellimused).
2. Päringud (Queries): Kasutatakse andmete lugemiseks. Klient näitab, milliseid välju ta soovib.
3. Mutatsioonid (Mutations): Kasutatakse andmete muutmiseks (loomine, uuendamine, kustutamine).
4. Tellimused (Subscriptions): Kasutatakse andmete saamiseks reaalajas püsiva ühenduse kaudu (näiteks WebSocket).

Päringu näide:

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

Selle päringu vastus võib välja näha järgmiselt:

{
  "data": {
    "user": {
      "name": "Ivan",
      "email": "ivan@example.com",
      "posts": [
        { "title": "Minu esimene artikkel" },
        { "title": "GraphQL-ist" }
      ]
    }
  }
}

Eelised REST-iga võrreldes:

• Üleliigsete andmete saamise vältimine (Over-fetching): Klient saab ainult küsitud väljad.
• Andmete puudus (Under-fetching) / Mitme päringu vajadus: Sageli võimaldab saada kogu vajaliku teabe ühe päringuga, erinevalt REST-ist, kus võib olla vaja mitu päringut erinevatele lõpp-punktidele.
• Täpne tüüpimine: Skeem tagab selge dokumentatsiooni ja päringute valideerimise.
• Tõhusama jõudluse saavutamine: Edastatavate andmete maht on väiksem.
• Kliendi poole paindlikkus: Kliendid saavad areneda sõltumatult serverist, pärides andmeid vastavalt vajadusele.

Miinused:

• Serveri poole konfiguratsioon on keeruline.
• Vahemälu probleemid võrreldes standardsete REST-vahemälu meetoditega (näiteks HTTP tasemel).
• Viga töötlemine on keerulisem kui REST-is (kus kasutatakse standardseid HTTP staatuseid).