REST API în protocolul HTTP
De obicei, la crearea site-urilor pentru obținerea, crearea, modificarea și ștergerea datelor sunt utilizate doar metodele GET și POST, deoarece acestea sunt bine suportate de browsere și servere. Același lucru este valabil și pentru API-urile furnizate de site-uri. Există însă, abordări speciale care standardizează API-urile pentru comoditatea generală atât a dezvoltatorilor de API, cât și a utilizatorilor săi.
Una dintre abordări este REST API (deseori se spune RESTful folosind acest cuvânt ca adjectiv). Baza acestui API este utilizarea pe scară largă a metodelor protocolului HTTP. În această abordare, cu metoda GET se obțin date, cu metoda POST se creează, cu metoda PUT se modifică, iar cu metoda DELETE - se șterg.
De exemplu, să luăm în considerare un API care manipulează utilizatori. Să vedem cum vor arăta URL-urile pentru diferite acțiuni.
Obținem toți utilizatorii:
GET http://api.loc/users/
Obținem un utilizator după id-ul său:
GET http://api.loc/user/1/
Creăm un utilizator:
POST http://api.loc/user/
Modificăm utilizatorul după id-ul său:
PUT http://api.loc/user/1/
Ștergem utilizatorul după id-ul său:
DELETE http://api.loc/user/1/
Să presupunem că aveți un API pentru produsele unui magazin online. Descrieți URL-urile magazinului astfel încât API-ul să devină RESTful.