Краткий обзор REST-API

По сути REST API принципиально отличается от обычного веб-приложения лишь тем, что проектируется для предоставления программным клиентам данных в "чистом виде", без их оформления с помощью HTML и CSS, в удобном для обработки формате.

В концепции REST принципиальное важно то, что каждый запрос на сервер содержит все необходимые данные для предоставления сервером полного ответа. Проще говоря, один запрос на сервер = один результат. Самый популярный пример использования REST - протокол HTTP. Также в традиционных REST API, как правило, не используются куки и сессии как способ передачи "состояния" на сервер - для этого достаточно данных в самом запросе.

При ответе на HTTP запросы сервер получает информацию не только о заголовках запроса и его содержимом, но и о запрашиваемом адресе и о выбранном методе запроса. Для создания REST API полезно знать, какие HTTP методы с какими действиями обычно ассоциируются.

Create - POST Read - GET Update - PUT Delete - DELETE

Запросы PUT и DELETE работают так же как и POST-запросы, но отличаются по смыслу выполняемой операции. Например, при GET запросе к /objects/1 сервер вернет информацию об объекте. При PUT запросе по тому же адресу он может обновить информацию об объекте на основании полученных данных. При DELETE запросе объект будет удален.

Правильное использование HTTP методов совместно с ЧПУ (человек-понятных УРЛ, "красивых ссылок") позволяет создать интуитивно понятный REST API.

Поскольку REST API это по-прежнему обычное веб-приложение, для использования REST API прекрасно подходит модуль request из предыдущих уроков. Также можно создать REST API с помощью стандартных функций работы с сетью или модуля express. В этом уроке мы рассмотрим похожий на express модуль restify. который предназначен специально для использования и создания REST API.