GraphQL ja REST: vertaa tarpeita, kustannuksia ja oikeuksia

Ymmärrä pyyntö ja sen kustannus

Esimerkki käyttää kuvitteellista skeemaa: kenttien customer, orders ja total on oltava oikeassa APIssa. Yksi pyyntö voi synnyttää useita palvelinlukuja. RESTkin voi tarjota kohdennettuja vastauksia. Yksi HTTP-päätepiste on GraphQL:ssa tavallinen, ei jokaisen arkkitehtuurin vaatimus.

query RecentOrders($id: ID!) {
  customer(id: $id) {
    name
    orders(first: 5) {
      nodes { id total }
    }
  }
}

Vertaa edustavaa tehtävää

• Mittaa tavut, viive, virheet ja palvelintyö samalla näkymällä, oikeuksilla ja realistisilla tietomäärillä.
• Tarkista sivutus, lukujen eräajo N+1-ongelman rajoittamiseksi, välimuisti ja tilien tietojen eristys.
• Arvioi skeeman kehitys, vanhojen asiakkaiden yhteensopivuus ja ylläpito. RESTin säilyttäminen voi olla yksinkertaisempaa.

Valvo oikeuksia ja kuormaa

Tunnista pyynnöt ja valvo objektien sekä kenttien oikeuksia liiketoimintalogiikassa. Rajaa listat, syvyys, aliakset, yhdistetyt operaatiot ja arvioitu kustannus. Pelkkä pyyntötiheys ei kuvaa kuormaa. Introspektion piilottaminen ei korvaa valvontaa; testaa myös kiellot ja osittaiset vastaukset.

Alkuperäiset lähteet

• GraphQL — Learn [EN]
• GraphQL — Performance [EN]
• GraphQL — Security [EN]