REST vs GraphQL: u čemu je razlika i koji da koristite?

REST i GraphQL su dva načina za dizajn API-ja — dogovoreni način na koji ekrani vaše aplikacije (ili drugi programi) traže podatke od vašeg backend-a. Kod REST-a postoji zaseban URL za svaku vrstu stvari, kao što su /customers ili /orders, a svaki vraća unapred zadat oblik podataka. Kod GraphQL-a obično postoji jedan URL, a pozivalac šalje upit koji navodi tačno koja polja želi nazad. Za većinu aplikacija pravljenih uz AI, REST je jednostavniji i bolji podrazumevani izbor.

Zašto ovo važi kada pravite uz AI

Kada od AI alata za pravljenje zatražite „aplikaciju sa backend-om“, on mora da izabere kako će frontend i backend da razgovaraju. Ne morate to odlučivati svaki put, ali ćete videti te pojmove u kodu, u dokumentaciji i kada se povezujete sa spoljnim servisima. Neki servisi nude samo jedan stil: mnogi servisi izlažu REST API-je, dok drugi — na primer Shopify i GitHub — nude ili preferiraju GraphQL. Poznavanje razlike pomaže vam da razumete ono što gledate i da izbegnete dodavanje složenosti koja vam ne treba. Ako vam je pojam „API“ nov, počnite sa šta je API.

Svakodnevna analogija

REST je fiksni meni u restoranu. Svako jelo (endpoint) stiže onako kako ga je kuhinja osmislila. Naručite jelo „customer“ i dobijate ceo tanjir — ime, email, adresu, datum registracije — iako ste hteli samo ime. Želite i nedavne porudžbine tog kupca? To je drugo jelo.

GraphQL je naručivanje „à la carte“ kod jednog konobara. Zapišete tačno šta želite: „ime kupca i datume i iznose njegove poslednje tri porudžbine“. Jedna porudžbina, jedan tanjir, samo ono što ste tražili. Ali kuhinja mora da bude spremna da obradi bilo koju kombinaciju koju kupci zapišu.

Isti zahtev, na oba načina

Recimo da stranica kupca treba ime kupca i njegove tri najnovije porudžbine.

Sa REST-om, to je obično dva zahteva:

GET /api/customers/42
GET /api/customers/42/orders?limit=3

Prvi odgovor može da sadrži više nego što stranici treba:

{ "id": 42, "name": "Lena Park", "email": "lena@example.com", "address": "…", "createdAt": "…" }

Sa GraphQL-om, to je jedan zahtev, obično POST na jedan endpoint kao što je /graphql, koji nosi upit:

query {
  customer(id: 42) {
    name
    orders(last: 3) {
      date
      total
    }
  }
}

A odgovor tačno odražava upit:

{
  "data": {
    "customer": {
      "name": "Lena Park",
      "orders": [
        { "date": "2026-09-20", "total": 48.0 },
        { "date": "2026-09-02", "total": 19.5 },
        { "date": "2026-08-15", "total": 72.25 }
      ]
    }
  }
}

Oba vraćaju JSON. Razlika je u tome ko odlučuje o obliku: kod REST-a to radi server; kod GraphQL-a pozivalac, u okviru onoga što šema servera dozvoljava.

Poređenje jedno pored drugog

Gde koji odgovara

Izaberite REST kada:

• Pravite tipičnu aplikaciju: sistem za rezervacije, CRM, kontrolnu tablu, prodavnicu.
• Jedan frontend razgovara sa jednim backend-om i kontrolišete oba.
• Želite najjednostavniju stvar za debagovanje, keširanje i zaštitu.
• Drugi servisi će pozivati vašu aplikaciju (webhook-ovi i većina integracija očekuju endpoint-e u REST stilu).

Razmotrite GraphQL kada:

• Nekoliko različitih klijenata — sajt, mobilna aplikacija, partnerske integracije — treba vrlo različite delove istih podataka.
• Vaši podaci su duboko povezani (proizvodi, varijante, recenzije, prodavci, zalihe) i ekrani ih moraju kombinovati na mnogo načina.
• Koristite servis koji nudi GraphQL kao glavni API.

Korisno pravilo: ako niste sigurni da vam treba GraphQL, verovatno ne treba. Lakše ga je dodati kasnije nego ukloniti.

Ključni pojmovi

Česte zablude

• „GraphQL je noviji, znači bolji je.“ Rešava određene probleme. Za jednu aplikaciju sa jednim frontend-om često dodaje posao bez velike koristi.
• „GraphQL je baza podataka.“ Nije. To je API sloj; iza njega server i dalje čita iz vaše baze podataka.
• „GraphQL je uvek brži.“ Manje zahteva može pomoći na sporim mobilnim mrežama, ali upit bez ograničenja može da učita ogromne količine podataka. Performanse zavise od backend-a.
• „REST znači strogi standard.“ U praksi, „REST API“ labavo znači URL-ove resursa, HTTP metode i JSON. Mnogi dobri API-ji savijaju formalna pravila.
• „Status 200 znači da je uspelo.“ Kod GraphQL-a proverite polje errors — zahtev može delimično da ne uspe, a da i dalje vrati 200.

Šta da tražite od AI alata

• „Koristi jednostavan REST API sa JSON-om, osim ako za to ne postoji jasan razlog — objasni ako misliš da je GraphQL potreban.“
• „Navedi svaki endpoint, šta vraća i ko sme da ga poziva.“
• „Za stranicu kupca vrati samo polja koja stranica koristi.“
• „Dodaj paginaciju na endpoint-e sa listama da nikada ne vraćaju hiljade redova odjednom.“
• „Ovaj servis ima samo GraphQL API — pozovi ga sa servera, čuvaj ključ kao tajnu vrednost i traži samo polja koja su nam potrebna.“
• „Vraćaj ispravne HTTP statusne kodove i JSON poruke o greškama.“

REST i GraphQL u Mythex-u

Mythex dokumentacija sadrži recept za pravljenje REST API backend-a sa početnim upitom, a backend može da radi u Node, Python (FastAPI), C# ili Java uz vašu web aplikaciju. Dokumentacija ne opisuje GraphQL šablon, pa ako ga želite, izričito to zatražite i kažite zašto. Pozivanje GraphQL API-ja treće strane radi kao i svaki drugi spoljni servis — pogledajte integrišite bilo koji API. Povezano štivo: frontend vs backend i kako napraviti REST API.

Pitanja