REST: различия между версиями
Patarakin (обсуждение | вклад) |
|||
| Строка 11: | Строка 11: | ||
{{#widget:YouTube|id=J4Fy6lmLBr0|start=5}} | {{#widget:YouTube|id=J4Fy6lmLBr0|start=5}} | ||
=== Методы === | |||
Как правило, для взаимодействия между клиентом и сервером достаточно четырех методов: | |||
GET — получение информации об объекте (ресурсе); | |||
POST — создание, а иногда и изменение объекта (ресурса); | |||
PUT — изменение объекта (ресурса). Обычно используется для регулярного обновления данных; | |||
DELETE — удаление информации об объекте (ресурсе). | |||
Реже используются методы LIST, UPDATE, PATCH и др. | |||
=== Коды ответов === | |||
Ответы от сервера содержат коды состояния для оповещения клиента об успехе операции. Как разработчику вам не нужно знать каждый код состояния (их много), но вы должны знать самые распространённые и то, как они используются. | |||
Для каждого метода НТТР ожидаются коды статуса, которые сервер должен вернуть в случае успеха: | |||
GET — return 200 (OK) | |||
POST — return 201 (CREATED) | |||
PUT — return 200 (OK) | |||
DELETE — return 204 (NO CONTENT) | |||
Если операция не работает, вернётся наиболее конкретный код состояния, соответствующий возникшей проблеме. | |||
Версия 01:02, 1 декабря 2023
| Описание | REST (от англ. Representational State Transfer — «передача репрезентативного состояния» или «передача „самоописываемого“ состояния») — архитектурный стиль взаимодействия компонентов распределённого приложения в сети. Другими словами, REST — это набор правил того, как программисту организовать написание кода серверного приложения, чтобы все системы легко обменивались данными и приложение можно было масштабировать. REST представляет собой согласованный набор ограничений, учитываемых при проектировании распределённой гипермедиа-системы. |
|---|---|
| Область знаний | Информатика, Интернет вещей |
| Авторы | Филдинг |
| Поясняющее видео | https://www.youtube.com/watch?v=J4Fy6lmLBr0 |
| Близкие понятия | API, HTTP, URL, JSON, WWW |
| Среды и средства для освоения понятия | MediaWiki API |
Идентификация ресурсов
Все ресурсы идентифицируются в запросах, например, с использованием URI в интернет-системах. Ресурсы концептуально отделены от представлений, которые возвращаются клиентам. Например, сервер может отсылать данные из базы данных в виде HTML, XML или JSON, ни один из которых не является типом хранения внутри сервера.
Методы
Как правило, для взаимодействия между клиентом и сервером достаточно четырех методов:
GET — получение информации об объекте (ресурсе);
POST — создание, а иногда и изменение объекта (ресурса);
PUT — изменение объекта (ресурса). Обычно используется для регулярного обновления данных;
DELETE — удаление информации об объекте (ресурсе).
Реже используются методы LIST, UPDATE, PATCH и др.
Коды ответов
Ответы от сервера содержат коды состояния для оповещения клиента об успехе операции. Как разработчику вам не нужно знать каждый код состояния (их много), но вы должны знать самые распространённые и то, как они используются.
Для каждого метода НТТР ожидаются коды статуса, которые сервер должен вернуть в случае успеха:
GET — return 200 (OK)
POST — return 201 (CREATED)
PUT — return 200 (OK)
DELETE — return 204 (NO CONTENT)
Если операция не работает, вернётся наиболее конкретный код состояния, соответствующий возникшей проблеме.
