Для разработчиков

REST используется для создания легковесных, поддерживаемых и масштабируемых веб-сервисов. Сервис, построенный на REST архитектуре, называется RESTful-сервисом. REST использует HTTP — базовый транспортный протокол.

“ REST — это способ получить доступ к ресурсам, которые находятся в определённой среде. ”

НПО Кристалл

Например, у вас может быть сервер с важными документами или чертежами. Всё это — ресурсы. Если клиенту, скажем, веб-браузеру, нужны какие-то из этих ресурсов, ему необходимо отправить запрос на сервер для получения доступа к ним. REST определяет, как может осуществляться доступ к этим ресурсам.

1. Ресурсы. Допустим, у нас есть сервер с записями о сотрудниках, а адрес веб-приложения — https://npokristal.ru. Чтобы получить доступ к записи сотрудника, мы можем выполнить команду https://npokristal.ru/api/employee/1, которая говорит серверу предоставить запись сотрудника под номером 1.
2. Методы запросов. Они говорят, что вы хотите сделать с ресурсом. Браузер использует метод GET, чтобы проинформировать удалённую сторону о том, что он хочет получить данные. Кроме GET есть много других методов вроде POST, PUT и DELETE. В примере с https://npokristal.ru/api/employee/1 выше браузер на самом деле использует метод GET, поскольку он хочет получить данные о сотруднике.
3. Заголовки запроса. Это дополнительные инструкции, посылаемые вместе с запросом. Они могут определять тип необходимого ресурса или подробности авторизации.
4. Тело запроса. Это данные, отправляемые вместе с запросом. Данные обычно отправляются, когда выполняется POST-запрос к REST веб-сервису. Зачастую в POST-запросе клиент говорит серверу, что он хочет добавить на него ресурс. Следовательно, тело запроса содержит подробную информацию о ресурсе, который необходимо добавить на сервер.
5. Тело ответа. Это основная часть ответа. В нашем примере на запрос https://npokristal.ru/api/employee/1 сервер присылает JSON-документ с данными о сотруднике в теле ответа.
6. Коды ответа. Эти коды возвращаются сервером вместе с ответом. Например, код 200 обычно означает, что при отправке ответа не произошло никакой ошибки.

1. Разнородные языки и среды — это одна из основных причин:

• У веб-приложений, написанных на разных языках, есть возможность взаимодействовать друг с другом;
• Благодаря RESTful эти приложения могут находиться в разных средах, будь то Windows или Linux.

Представим, что для работы с такими сайтами как Twitter, Google и т.д. клиентскому приложению нужно знать, на каких языках и на какой платформе они написаны. Основываясь на этих знаниях, мы могли бы написать код для взаимодействия с ними, однако это превратилось бы в сущий ад.

Twitter и Google дают доступ к их функциональности посредством RESTful веб-сервисов. Это даёт возможность любому клиентскому приложению взаимодействовать с этими сервисами с помощью REST.

2. Технологический бум – сегодня всё должно работать на разнообразных устройствах, будь то смартфон, ноутбук или кофеварка. Представляете, каких бы усилий стоило наладить взаимодействие этих устройств с помощью обычных веб-приложений? RESTful API делают эту задачу гораздо проще, поскольку, как было упомянуто выше, вам не нужно знать, что у устройства «под капотом».

3. Появление облачных сервисов — всё переезжает в облако. Приложения медленно перемещаются в облачные системы вроде Azure или Amazon, которые предоставляют большое количество API на основе RESTful архитектуры. Следовательно, приложения должны разрабатываться таким образом, чтобы они были совместимы с облаком. Так как все облачные архитектуры работают на основе REST, логично разрабатывать веб-сервисы тоже на REST-архитектуре, чтобы извлечь максимум пользы из облачных сервисов.

1. Состояние и функциональность представлены в виде ресурсов — это значит, что каждый ресурс доступен через обычные HTTP-запросы GET, POST, PUT или DELETE. Так, если кто-то хочет получить файл на сервере, у него есть возможность отправить GET-запрос и получить файл. Если он хочет загрузить файл на сервер, то у него есть возможность использовать POST или PUT-запрос. Наконец, если он хочет удалить файл, есть возможность отправить запрос DELETE.
2. Архитектура клиент-сервер, отсутствие состояния (stateless) и поддержка кеширования:
   • Клиент-сервер — архитектура, где сервером выступает веб-сервер, на котором размещён программный комплекс Кристалл, а клиентом может выступать обычный веб-браузер или Android приложение;
   • Архитектура без сохранения состояния означает, что состояние приложения не сохраняется в REST. Например, если вы удалили ресурс с сервера командой DELETE, то даже при получении положительного кода ответа нет гарантий, что он действительно был удалён. Чтобы убедиться, что ресурс удалён, необходимо отправить GET-запрос. С его помощью можно запросить ресурсы, чтобы посмотреть, присутствует ли там удалённый.