Что означает архитектурный стиль REST?

REST архитектурный стиль

REST (Representational State Transfer) — это архитектурный стиль для проектирования API. Не протокол, а набор принципов.

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

1. Client-Server

• Клиент и сервер разделены
• Клиент делает запрос, сервер отвечает
• Они могут развиваться независимо

2. Stateless (без состояния)

• Каждый запрос содержит всю информацию
• Сервер не хранит session клиента между запросами
• Каждый запрос независимый

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

• Ответы можно кешировать
• GET запросы кешируются
• POST обычно не кешируется

4. Uniform Interface (единообразный интерфейс)

• Ресурсы идентифицируются в requests (URL)
• GET /users/123 (получить юзера 123)
• Операции над ресурсами через HTTP методы

REST ресурсы и операции

Ресурсы = существительные:

• /users (пользователи)
• /products (товары)
• /orders (заказы)

Операции = HTTP методы:

• GET /users — получить список
• POST /users — создать
• GET /users/123 — получить одного
• PUT /users/123 — заменить
• DELETE /users/123 — удалить

Статус коды REST

• 200 OK (успех)
• 201 Created (создано)
• 204 No Content (успех, нет контента)
• 400 Bad Request (ошибка клиента)
• 401 Unauthorized (нет авторизации)
• 404 Not Found (ресурс не найден)
• 500 Server Error (ошибка сервера)

Для QA при тестировании REST

Проверяю:

• URL используют существительные (не глаголы)
• HTTP методы правильные
• Статус коды корректные
• Response содержит правильный Content-Type
• Ресурсы доступны по предсказуемым путям

REST — стандарт, поэтому API должны быть предсказуемы и consistent.