GraphQL vs REST for Business APIs: Juman bɛ waati ni wari caman bɔ i la?

Bi porozɛw diɲɛ kɔnɔ , API ye i ka jago ka nɛrɛmuguma ye . A b’i ka CRM ni i ka fatura modulu cɛsiri, i ka HR platform ni i ka analytics dashboard, ani i ka tech stack bɛɛ ni kɛnɛma diɲɛ cɛ. San caman kɔnɔ, REST ye sɔsɔli tɛ min na, o jɛɲɔgɔnyaw jɔli la. Nka o kɔfɛ, GraphQL sera yen, a ye layidu ta ko a bɛna kɛ fɛɛrɛ ɲuman ye, min bɛ se ka wuli ka bɔ a nɔ na walasa ka kunnafoniw sɔrɔ. Jɛkafɔ tɛ kɛ min kan ‘ka fisa’ yɔrɔ lakolon na; a bɛ tali kɛ min ka fisa i ka jago mago kɛrɛnkɛrɛnnenw na . Ni i ye kojugu sugandi, o bɛ se ka kɛ sababu ye ka yiriwali musakaw caya san fɛ, ka appli (application) baarakɛcogo sɛgɛn, ani ka ekipuw dusu tiɲɛ. Nin tɛ kalanko degeliw ye; o ye desizɔn nafama ye min bɛ nɔ bila i ka sɔrɔ la. An ka tigɛ ka tɛmɛn hype kan ka GraphQL ni REST suma ɲɔgɔn na ka bɔ jago siratigɛ la, k’an sinsin diɲɛ kɔnɔko lakikaw kan i n’a fɔ yiriwali teliya, baarakɛcogo musaka, ani sɛgɛsɛgɛli.

Filozofi koloma : hakilinata suguya fila

sanni ka don kode la , a nafa ka bon kosɛbɛ ka hakilina jɔnjɔnw faamuya minnu bɛ nin fɛɛrɛ ninnu kɔfɛ . REST, walima Representational State Transfer, ye fɛn dilanni cogoya ye min jɔlen bɛ nafolo hakilina lamini na. Nafolo kelen-kelen bɛɛ (i n’a fɔ ‘baarakɛla’, ‘fatura,’ walima ‘mobili’ min bɛ kurunba ɲɛnabɔli siratigɛ la) bɛ dɔn ni URL ye. I bɛ jɛɲɔgɔnya kɛ ni nin nafolomafɛnw ye ni HTTP fɛɛrɛ jɔnjɔnw ye: GET ka sɔrɔ, POST ka da, PUT ka update, ani DELETE ka bɔ. O ye misali tilennen ye, min faamuyalen don kosɛbɛ, min bɛ ɛntɛrinɛti yɛrɛ baaracogo jira.

GraphQL kɔni ye ɲininkalikan ni baarakɛcogo ye APIw kama. A ka hakilina jɔnjɔn ye kiliyan-kɔrɔsigi ye. Sani labanyɔrɔ caman ka segin kunnafonidilan jɔlenw kan, GraphQL bɛ labanyɔrɔ kelen di. Client bɛ ɲininkali ci min b’a ɲɛfɔ tigitigi a mago bɛ kunnafoni minnu na, ani baarakɛla bɛ jaabi di ni JSON fɛn ye min bɛ bɛn ɲininkali cogoya ma. Nin jiginni in ka bɔ API la min ɲɛfɔlen don baarakɛla fɛ ka taa a ɲɛfɔlen don kiliyan fɛ, o de ye a fanga n’a ka gɛlɛya fila bɛɛ sɔrɔyɔrɔ ye.

baarakɛcogo ni baarakɛcogo ɲuman : kunnafonidi kɛlɛ

A ka c'a la, nin ye GraphQL nafa fɔlɔ ye min bɛ fɔ kosɛbɛ.

Tɛmɛn-ka-segin-ka-bɔ-yɔrɔ-ko gɛlɛya

REST APIs frequently suffer from two issues. Tuma caman sɔrɔli bɛ kɛ ni labanyɔrɔ dɔ ye kunnafoni caman segin ka tɛmɛ kiliyan mago kan . Misali la, mobili porogaramu min bɛ kiliyan tɔgɔw lisɛli jira, o bɛ se ka `/users` labanyɔrɔ wele min bɛ baarakɛlaw ka kunnafoni dafalenw segin ni ladɛrɛsiw, telefɔni nimɔrɔw ani kunnafoni wɛrɛw ye minnu ma baara kɛ. O bɛ bandwidth tiɲɛ ani ka appli (application) sumaya. Under-fetching bɛ kɛ ni labanyɔrɔ kelen ma kunnafoni bɛrɛ di, o bɛ kiliyan wajibiya ka API weleli wɛrɛw kɛ. Walasa ka baarakɛla dɔ ka kɔsa in na yamaruyaw jira, i bɛ se ka fɔlɔ ka `/users/123` wele ka sɔrɔ ka `/users/123/orders` wele, o bɛ na ni taa ni segin caman ye.

GraphQL ka tiɲɛni

GraphQL bɛ nin ɲɛnabɔ cogo cɛɲi na. Client bɛ se ka `id` ni `name` forow dɔrɔn de ɲini baarakɛlaw ka lisi kama, wa o ɲininkali kelen in na, a bɛ `orderId` ni `date` ɲini u ka kɔsa in na komandiw la. O bɛ na ni ɲinini ni jaabi kelen ye min bɛ kɛ tigitigi. Jagokɛyɔrɔw la minnu ka ca ni kunnafonidilanw ye i n’a fɔ Mewayz ka jateminɛ modulu, o bɛ se ka dɔ bɔ nafamafɛnw hakɛ la ni 70% ye walima ka tɛmɛ o kan, ka baara kɛcogo ɲɛ kosɛbɛ, kɛrɛnkɛrɛnnenya la telefɔni selilɛriw kan.

Yɛlɛmabaaw ka ko kɛlenw ni u ka teliya

O API ninnu bɛ nɔ jumɛn bila ekipuw jɔli n' u ladonni na ?

LAFIYA : Nɔgɔya ni kɔrɔfɔli

REST fanga bɛ a nɔgɔya la . Fɛn dilannikɛlaw mago t’a la ka ɲininkalikan kura dege. A labanw bɛ se ka fɔ ka ɲɛ, wa a kɛcogo bɛ kɛ cogo la min bɛ bɛn sariya ma. Baarakɛminɛn minnu bɛ i n’a fɔ Swagger/OpenAPI, olu bɛ REST APIw sɛbɛnni n’u kɔrɔbɔli nɔgɔya. Ekipu fitininw walima porozɛ minnu ka kunnafonidilanw ɲinini tilennen don, o nɔgɔya in bɛ baara kɛ ni yiriwali fɔlɔ teliya ye ani kalan kɛcogo nɔgɔman.

GraphQL : Fanga ni Frontend Hɔrɔnya

GraphQL bɛ fanga di ɲɛfɛla dilannikɛlaw ma. U bɛ se ka kunnafonidilanw faralen ɲɔgɔn kan cogo o cogo ɲini k’a sɔrɔ u ma kɔkanjɛkuluw makɔnɔ u ka labanyɔrɔ kura da. O bɛ se ka iterasiyɔn teliya kosɛbɛ ɲɛfɛla la. Nka, o fanga in bɛ na ni musaka ye. GraphQL ɲɛnabɔbaga ɲumanw sɛbɛnni kɔkanna kan, o ka gɛlɛn ka tɛmɛ REST ɲɛnabɔbaga nɔgɔmanw jɔli kan. Farati fana bɛ yen ɲininkaliw la minnu ma jɔ ka ɲɛ, olu bɛ kɛ sababu ye ka baarakɛcogo gɛlɛyaw lase (‘n+1’ gɛlɛya tɔgɔjuguba).

Caching : A jɛlen don ka ɲɛsin REST ma?

Caching nafa ka bon kosɛbɛ sɛgɛsɛgɛli ni baarakɛcogo la. REST nafa ka bon yan bawo a bɛ HTTP caching fɛɛrɛ jɔlenw nafa. Ikomi REST labanyɔrɔ kelen-kelen bɛɛ ye URL kɛrɛnkɛrɛnnen ye, navigatɔrɔw, CDNw ani reverse proxyw bɛ se ka GET jaabiw mara nɔgɔya la. Delili min bɛ kɛ `/invoices/latest` la, o bɛ se ka mara miniti walima lɛrɛ caman kɔnɔ, ka dɔ bɔ sèrwɛri doni na.

GraphQL, n’a labanyɔrɔ kelen ani ɲininkali minnu sinsinnen bɛ POST kan (hali kalanw kama), o bɛ HTTP caching layers ninnu tɛmɛn. Hali ni gafemarayɔrɔw ni misaliw bɛ yen minnu bɛ GraphQL jaabiw mara (misali la, ɲininkali basigilenw, Apollo Client ka cakɛda), u waleyali n’u ɲɛnabɔli ka gɛlɛn ka tɛmɛ HTTP cakɛda kan. Foroba-ɲɛnajɛ APIw kama, yɔrɔ minnu na caching (cache) de ka bon kosɛbɛ, o ye jateminɛba ye.

API sɛgɛsɛgɛli ni a bɔcogo

I bɛ se k' i ka API Changer cogo di k'a sɔrɔ i ma kliyan kɔrɔw tiɲɛ ?

Ni REST ye, fɛn caman tigɛli bɛ API versioning de wajibiya tuma caman na (misali la, `/v1/users` ka taa `/v2/users` la). O bɛ se ka kɛ sababu ye ka bɔko caman mara waati kelen na, o bɛ dɔ fara gɛlɛya kan. GraphQL bɛ a yɛrɛ tanga o ma a cogoya fɛ. Ikomi kiliyanw bɛ foro kɛrɛnkɛrɛnnenw ɲini, i bɛ se ka forow ni suguya kuraw fara sɛgɛsɛgɛli kan k’a sɔrɔ i ma nɔ bila ɲininkali kɔrɔw la. Forow dɔgɔyali fana bɛ don a kɔnɔ, o bɛ sira di API jiginni ma min ka di kosɛbɛ ani min bɛ dɔ fara a kan. Nin ye nafaba ye baarakɛminɛnw na minnu bɛ mɛn ni kiliyan caman ye minnu bɛ ɲɔgɔn kan.

Lakanali ni hakɛ dantigɛli

I ka API doncogo lakanani n' a kɔlɔsili tɛ bɛnkan ye .

REST ka sigicogo bɛ lakana wale dɔw kɛ ka ɲɛ . Dantigɛli bɛ se ka kɛ labanyɔrɔ kelen-kelen bɛɛ la—i bɛ se ka sira di weleli caman ma ka taa labanyɔrɔ la min bɛ kalan dɔrɔn ka tɛmɛ yɔrɔ kan min bɛ faturaw dilan. Ni GraphQL ye, ikomi ɲininiw bɛɛ bɛ labanyɔrɔ kelen Sɔrɔ, rate limiting bɛ Kɛ nuanced (nuancɛ) ye. You can't simply limit by URL. O nɔ na, ​​i ka kan ka ɲininkali yɛrɛ ka gɛlɛya sɛgɛsɛgɛ, o min bɛ baarakɛminɛnw caman ɲini. Tiɲɛni ni yamaruya fana mago bɛ dilancogo ɲuman na walasa ka kɛwale juguw bali ka ɲininkali sɔngɔ gɛlɛnw dilan minnu bɛ se ka baarakɛminɛnw degun.

Desizɔn waleyali hukumu : waati jumɛn ka kan ka min sugandi

O tuma na fɛ, i ka kan ka jumɛn sugandi ? Nin ye taamasiyɛn ye min bɛ kɛ senfɛ-senfɛ walasa k’aw dɛmɛ ka latigɛ kɛ.

1. aw ka kunnafonidilanw ni ɲɔgɔn cɛ jɛɲɔgɔnyaw sɛgɛsɛgɛ : yala aw ka kiliyanw (web, mobili) ka teli ka kunnafoniw ta ka bɔ kunnafonidilan caman na minnu bɛ tali kɛ ɲɔgɔn na, filɛli kelen kɔnɔ wa ? Ni ɔwɔ, GraphQL ka se ka ɲininkaliw kɛ nest ye, o ye nafa barikama ye. Miiri dashboard dɔ la min bɛ porozɛ dɔ jira, a jɛkulu kɔnɔmɔgɔw, ani u ka baara kɛlen kɔsa in na waati kelen na.
2. I ka i ka kiliyanw jateminɛ : Yala i bɛ API dɔ jɔ kiliyan suguya caman ye (misali la, foroba API) ni kunnafonidilanw magow ye minnu tɛ se ka fɔ wa ? GraphQL ka sɛgɛsɛgɛli bɛ yeelen bɔ yan. Yala sigida min bɛ kɔrɔsi kosɛbɛ, i n’a fɔ kɔnɔna ɲɛmɔgɔya baarakɛminɛn wa? REST ka nɔgɔya bɛ se ka kɛ sababu ye.
3. aw ka jɛkulu ka dɔnniya jateminɛ : yala aw ka jɛkulu ka dɔnniya bɛ GraphQL n' a ka ɲɛnamaya kɛcogo la wa ? N’o tɛ, aw ye kalan kɛcogo jateminɛ ani baarakɛcogo fɔlɔ jaanw seko.
4. Labɛn ka ɲɛsin Caching ma : Yala i ka baarakɛminɛn kalanni ka gɛlɛn wa a bɛna nafa caman sɔrɔ HTTP caching nɔgɔman na wa ? Nin ye hakilina ye min bɛ REST.
5. Miiri waatijan kɔnɔ : Fɛn min bɛ i n’a fɔ Mewayz min bɛ wuli joona ni modulu 208 ye, GraphQL ka se ka API yiriwa k’a sɔrɔ a ma kɛ ni version ye, o bɛ se ka dɔ bɔ ladonni kuntaalajan musakaw la.

Sugandili ɲuman tɛ fɛɛrɛko yɛrɛ de kan , nka a bɛ gɛlɛya kɛrɛnkɛrɛnnen min ɲɛnabɔ i ka jago la . GraphQL ka fisa ni kunnafonidilanw baarakɛcogo ɲuman ni ɲɛfɛla teliya gɛlɛyaw ɲɛnabɔli ye, k’a sɔrɔ REST ka fisa ni nɔgɔya, caching ani bɛnkanba ye.

Sini ye Hybride ye

The future of APIs isn't necessarily a winner-take-all battle. An bɛ ka dɔ fara an ka fɛɛrɛ ye min bɛ se ka kɛ, min bɛ kɛ ni ɲɔgɔndan ye. Kɔnpɔsitɛriw bɛ se ka baara kɛ ni REST API ye nafolo baara nɔgɔmanw kama, minnu bɛ se ka mara ani ka GraphQL labanyɔrɔ dɔ jira kunnafoni ɲininkali gɛlɛnw kama, minnu bɛ lajɛ ɲɔgɔn fɛ, minnu bɛ fanga di baarakɛminɛn kɛrɛnkɛrɛnnenw ma. Mewayz ka API-as-a-service modɛli, n’a sɔngɔ ye dɔrɔmɛ 4,99 ye modulu kelen-kelen bɛɛ la, o bɛ jɔyɔrɔ dafalen na walasa ka nin siniɲɛsigi ɲɔgɔndan in dɛmɛ, k’a to jagokɛlaw bɛ se ka baarakɛminɛn ɲuman ta baara kelen-kelen bɛɛ kama u ka ɲɛnamaya kɛcogo kɔnɔ.

A laban na, i ka sugandili GraphQL ni REST cɛ ka kan ka ɲɛsin i ka jago kuntilenna ma. N’i ​​bɛ baarakɛminɛn barikama dɔ jɔ yɔrɔ min na baarakɛcogo bɛ kɛ rezo suguya caman kan, wa i ka kan ka taa teliya la ɲɛfɛla la, GraphQL ye sugandili ye min bɛ mɔgɔ bila ka miiri. N’i ​​bɛ API sabatilen dɔ jɔ, min ka ca ni cache ye, lamɛnnikɛlaw ye minnu ɲɛfɔlen don koɲuman, REST bɛ to baarakɛso barikama ye min bɛ se ka da a kan. Ni i ye jagokɛtaw faamuya, i bɛ se ka desizɔn ta min bɛ kɛ ni kunnafoni ye, min bɛ waati bɔ, ka musakaw dɔgɔya, ka jusigilan jɔ min bɛ se ka muɲu i ka jago la.

Ɲininkali minnu bɛ kɛ tuma caman na

Ne bɛ se ka baara kɛ ni GraphQL ni REST fila bɛɛ ye baarakɛminɛn kelen kɔnɔ wa ?

A bɛrɛbɛrɛ. Fɛɛrɛ min bɛ kɛ ni ɲɔgɔndan ye, o bɛ kɛ tuma caman na, ka REST kɛ labanyɔrɔ nɔgɔmanw kama, minnu bɛ se ka mara ani GraphQL ye kunnafonidilanw ni ɲɔgɔn cɛ gɛlɛnw kama ani u faralen ɲɔgɔn kan appli kelen kɔnɔ.

Yala GraphQL lakananen don ka tɛmɛ REST kan wa ?

A tɛ kɛ danbe la . O fila bɛɛ bɛ lakana fɛɛrɛw waleyacogo ɲuman de wajibiya. GraphQL bɛ gɛlɛya kɛrɛnkɛrɛnnenw don sen kan i n’a fɔ ɲininkali juguya dantigɛli walasa ka baarakɛcogo banbali binkanniw bali.

Yala GraphQL bɛ kɔkanko mago bila a nɔ na wa ?

Ayi. GraphQL ye layɛrɛ ye min bɛ i ka kɔkanna baarakɛminɛnw ni kunnafonidilanw sanfɛ. I ka kan hali bi ka ɲɛnabɔbagaw sɛbɛn minnu bɛ kunnafoniw ta ani k’u labɛn ka bɔ i ka sitɛmu kɔrɔw la.

jun de teliya ka bon mobili baarakɛminɛnw na ?

GraphQL ka teli ka baarakɛlaw ka baarakɛcogo teliya di telefɔni selilɛri kan k’a sababu kɛ kunnafonidilanw tali tɛmɛnen dɔgɔyali ye, o bɛ na ni nafamafɛnw dɔgɔyali ye ani ɛntɛrinɛti ɲininiw dɔgɔyali.

Yala GraphQL kalanni ka gɛlɛn ka tɛmɛ REST kan wa ?

Frontend baarakɛlaw fɛ, GraphQL bɛ se ka nɔgɔya kunnafonidilan gɛlɛnw sɔrɔli la. Backend developpeurw fɛ, kalan siraba dɔ bɛ yen min ka gɛlɛn walasa ka GraphQL servers ɲumanw ni lakananenw waleya ni i y’a suma ni REST controleurs nɔgɔmanw ye.