REST vs GraphQL

REST vs GraphQL

U ovoj lekciji razmatramo REST vs GraphQL u okviru kursa REST API Masterclass – Od nule do profesionalnog API-ja u PHP-u. Fokus je na PHP 8 implementaciji REST API-ja sa JSON odgovorima, ispravnim HTTP status kodovima i strukturom pogodnom za mobilne i web klijente.

Modul «Uvod u API i HTTP» gradi praktične veštine korak po korak: od teorije do rada sa routerom, kontrolerima, JWT autentifikacijom i deploy-om. Svaki primer koristi employee/users domen kao referentni model — blisko završnom projektu employee management sistema.

Detaljnije

Detaljno objašnjavamo REST vs GraphQL: kako dizajnirati endpoint, koje HTTP metode i status kodove koristiti, kako formatirati JSON telo i greške. U PHP sloju koristite ResponseHelper i ErrorHandler klase da odgovori budu konzistentni. Testirajte sa curl i Postman pre nego što promenu pustite u staging okruženje.

Ključne tačke

• Razumevanje koncepta: REST vs GraphQL u kontekstu REST API-ja.
• Mapiranje HTTP metode, status koda i JSON envelope-a na poslovni slučaj.
• Implementacija u PHP 8 sa odvojenim router, controller i model slojem.
• Testiranje endpointa curl-om ili Postman kolekcijom pre produkcije.
• Dokumentovanje očekivanog ulaza, izlaza i grešaka u OpenAPI specifikaciji.
• Bezbednosna provera: autentifikacija, validacija i rate limiting gde je potrebno.
• Merenje performansi i logovanje zahteva radi održavanja u produkciji.

Česta greška

Česta greška kod REST vs GraphQL je mešanje GET i POST semantike, vraćanje HTML umesto JSON-a, pogrešan status kod (npr. 200 umesto 404) ili izlaganje SQL/stack trace klijentu. U produkciji uvek koristite HTTPS, validaciju ulaza i centralizovan error handler.

Rezime

Nakon ove lekcije razumete REST vs GraphQL i možete ga primeniti u svom PHP REST API projektu. Vežbajte na lokalnom api/ folderu sa index.php routerom i dokumentujte endpoint u OpenAPI pre sledeće lekcije modula 1.

Praktična primena

Testirajte endpoint iz lekcije u Postman-u ili curl-u. Proverite status kod i JSON telo odgovora.