Šta je API
Šta je API
U ovoj lekciji razmatramo Šta je API 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 Šta je API: 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: Šta je API 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.
Primer u praksi
Primer GET poziva ka REST API-ju
curl -i https://api.example.com/v1/users
# HTTP/1.1 200 OK
# Content-Type: application/json
# {"data":[{"id":1,"email":"ana@firma.rs"}]}Česta greška
Česta greška kod Šta je API 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 Šta je API 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.