REST

REST (RESTful) — это общие принципы организации взаимодействия приложения/сайта с сервером посредством протокола HTTP. Особенность REST в том, что сервер не запоминает состояние пользователя между запросами - в каждом запросе передаётся информация, идентифицирующая пользователя (например, token, полученный через OAuth-авторизацию) и все параметры, необходимые для выполнения операции.

Всё взаимодействие с сервером сводится к 4 операциям (4 — это необходимый и достаточный минимум, в конкретной реализации типов операций может быть больше):

  1. получение данных с сервера (обычно в формате JSON, или XML)
  2. добавление новых данных на сервер
  3. модификация существующих данных на сервере
  4. удаление данных на сервере

Операция получения данных не может приводить к изменению состояния сервера.

Для каждого типа операции используется свой метод HTTP-запроса:

  1. получение — GET
  2. добавление — POST
  3. модификация — PUT
  4. удаление — DELETE

Примеры:

GET-запрос/rest/usersполучение информации о всех пользователях
GET-запрос/rest/users/125получение информации о пользователе с id=125
POST-запрос/rest/usersдобавление нового пользователя
PUT-запрос/rest/users/125изменение информации о пользователе с id=125
DELETE-запрос/rest/users/125удаление пользователя с id=125

Мануалы: