REST API w protokole HTTP
Zazwyczaj przy tworzeniu stron internetowych do pobierania, tworzenia, zmiany i usuwania danych używane są tylko metody GET i POST, ponieważ są one dobrze obsługiwane przez przeglądarki i serwery. To samo dotyczy API dostarczanych przez strony internetowe. Istnieją jednak specjalne podejścia, standaryzujące API dla wspólnej wygody zarówno twórców API, jak i jego użytkowników.
Jednym z podejść jest REST API (często mówi się RESTful używając tego słowa jako przymiotnika). Podstawą tego API jest szerokie wykorzystanie metod protokołu HTTP. W tym podejściu za pomocą metody GET pobierane są dane, za pomocą metody POST tworzone są, za pomocą metody PUT modyfikowane, a za pomocą metody DELETE - usuwane.
Dla przykładu rozważmy pewne API, manipulujące użytkownikami. Spójrzmy, jak będą wyglądać URL dla różnych działań.
Pobieramy wszystkich użytkowników:
GET http://api.loc/users/
Pobieramy jednego użytkownika po jego id:
GET http://api.loc/user/1/
Tworzymy użytkownika:
POST http://api.loc/user/
Modyfikujemy użytkownika po jego id:
PUT http://api.loc/user/1/
Usuwamy użytkownika po jego id:
DELETE http://api.loc/user/1/
Załóżmy, że masz API produktów sklepu internetowego. Opisz adresy URL sklepu tak, aby API stało się RESTful.
