Что такое REST API?

REST API — это способ построения веб-сервисов на основе архитектурного стиля REST, где ресурсы адресуются через URL, а действия над ними выражаются HTTP-методами.

Основные принципы REST

• Ресурсы и URL — каждая сущность имеет адрес: /users/1.
• HTTP-методы как действия — GET (читать), POST (создать), PUT/PATCH (обновить), DELETE (удалить).
• Stateless — сервер не хранит состояние клиента между запросами; каждый запрос самодостаточен.
• Единообразие интерфейса — предсказуемая структура URL и ответов.
• Представления — данные передаются обычно в JSON.

Пример

GET    /users        # список
GET    /users/1      # один пользователь
POST   /users        # создать
PATCH  /users/1      # частично обновить
DELETE /users/1      # удалить

Статус-коды

• 2xx — успех (200 OK, 201 Created).
• 4xx — ошибка клиента (400, 401, 404).
• 5xx — ошибка сервера.

REST против альтернатив

GraphQL — один эндпоинт с гибкими запросами; gRPC — бинарный протокол. REST прост и повсеместен.

Коротко для собеседования

REST API — сервис, где ресурсы адресуются URL, а действия задаются HTTP-методами (GET/POST/PUT/PATCH/DELETE). Принципы: stateless, единообразие, ресурсно-ориентированность, JSON-представления и осмысленные статус-коды.