Концепции RESTful API

REST API (Representational State Transfer Application Programming Interface) — это архитектурный стиль программного обеспечения, основанный на протоколе HTTP и используемый для создания интерфейсов веб-приложений.

REST API — один из наиболее часто используемых шаблонов проектирования API в современной разработке веб-сервисов.


Что такое API?

Основные понятия API

API (Application Programming Interface) — это как «переводчик» между разными программами. Представьте, что вы пришли в ресторан в чужой стране. Вы не говорите на местном языке, но официант говорит на вашем языке. Он — «интерфейс» между вами и шеф-поваром.

В мире программирования API позволяют разным программным системам взаимодействовать и сотрудничать друг с другом. Например:

  • Вашему мобильному приложению погоды нужно получать данные о погоде
  • Вашему приложению для покупок нужно обрабатывать платежи
  • Вашему приложению социальных сетей нужно загружать фотографии

Роль API

Основные роли API включают:

  1. Обмен данными: позволяет разным системам передавать информацию
  2. Повторное использование функций: позволяет не изобретать велосипед, используя готовые сервисы
  3. Разделение системы: позволяет разрабатывать фронтенд и бэкенд независимо
  4. Контроль безопасности: контролирует, кто имеет доступ к каким данным

Аналогия API из реальной жизни

Представьте API как меню ресторана:

  • Меню— это документация API, которая говорит, что вы можете заказать
  • Заказ еды— это отправка запроса, сообщающая официанту, что вы хотите
  • Подача еды— это получение ответа, получение еды, которую вы хотите
  • Официант— это API, отвечающий за передачу ваших потребностей на кухню

Что такое REST?

Значение REST

REST (Representational State Transfer) звучит сложно, но на самом деле это набор правил и соглашений для проектирования веб-API. Так же как для строительства дома нужно соблюдать строительные нормы, для проектирования API нужно соблюдать определённые стандарты.

Шесть принципов REST

1. Клиент-серверная архитектура

Фронтенд (клиент) и бэкенд (сервер) полностью разделены, так же как посетители отделены от кухни.

2. Отсутствие состояния

Каждый запрос независим, и сервер не помнит предыдущие запросы. Точно так же, как каждый раз, когда вы приходите в банк по делам, вам нужно снова предъявить удостоверение личности.

3. Кэшируемость

Данные ответа можно кэшировать для повышения производительности, точно так же, как браузеры кэшируют изображения веб-страниц.

4. Унифицированный интерфейс

Все API следуют одним и тем же правилам и форматам, точно так же, как все меню ресторанов имеют похожую структуру.

5. Слоистая система

Система может иметь несколько слоёв, например: Клиент → Балансировщик нагрузки → API-сервер → База данных

6. Код по требованию (необязательно)

Сервер может отправлять исполняемый код клиенту, например JavaScript.

Почему выбирают REST?

  • Простой и понятный: основан на протоколе HTTP, лёгок в изучении
  • Легковесность: не требует дополнительных накладных расходов протокола
  • Масштабируемость: новые функции можно легко добавлять
  • Кроссплатформенность: любое устройство, способное отправлять HTTP-запросы, может его использовать
Другие расширения