Чем отличаются REST и RESTful API?

// REST - принципы архитектуры
// RESTful API - практическая реализация
GET /api/users/123     // ✅ RESTful реализация REST принципов
POST /getUserById      // ❌ Не RESTful, не следует REST

// REST - это набор принципов:
// 1. Client-Server архитектура
// 2. Stateless (без состояния)
// 3. Cacheable (кешируемость)
// 4. Uniform Interface (единый интерфейс)
// 5. Layered System (слоистая система)
// 6. Code on Demand (код по требованию)

// RESTful API - практическое воплощение
const api = {
  getUsers: () => fetch('/api/users'),           // GET
  createUser: (data) => fetch('/api/users', {    // POST
    method: 'POST',
    body: JSON.stringify(data)
  }),
  updateUser: (id, data) => fetch(`/api/users/${id}`, { // PUT
    method: 'PUT',
    body: JSON.stringify(data)
  }),
  deleteUser: (id) => fetch(`/api/users/${id}`, { // DELETE
    method: 'DELETE'
  })
};

// REST - концептуальный уровень
// Определяет ЧТО должно быть
 
// RESTful - практический уровень  
// Определяет КАК это реализовать

// Должен соответствовать ВСЕМ 6 принципам
// Полная stateless архитектура
// Обязательная кешируемость
// Строгий uniform interface

// Может частично следовать принципам
// Практические компромиссы
// Адаптация под реальные задачи

// Правильное использование HTTP методов
GET    /api/products        // Получить все продукты
GET    /api/products/123    // Получить продукт по ID
POST   /api/products        // Создать новый продукт
PUT    /api/products/123    // Обновить продукт полностью
PATCH  /api/products/123    // Частично обновить продукт
DELETE /api/products/123    // Удалить продукт

// Неправильное использование
POST /api/getProducts       // ❌ GET в POST
GET  /api/deleteUser/123    // ❌ DELETE в GET
POST /api/updateUserName    // ❌ UPDATE в POST

// RESTful реализация stateless
// Каждый запрос содержит всю необходимую информацию
const headers = {
  'Authorization': 'Bearer token123',
  'Content-Type': 'application/json'
};
 
fetch('/api/user/profile', { headers }); // ✅ Вся информация в запросе

// RESTful единообразие
const apiEndpoints = {
  users: '/api/users',
  products: '/api/products', 
  orders: '/api/orders'
};
 
// Одинаковые операции для всех ресурсов
// GET, POST, PUT, DELETE работают одинаково

// RESTful ресурсы
/api/users          // Коллекция пользователей
/api/users/123      // Конкретный пользователь
/api/users/123/posts // Посты пользователя
 
// Не RESTful
/api/getUserById/123     // ❌ Действие в URL
/api/createNewUser       // ❌ Действие в URL

// REST теория - идеальный мир
// Все 6 принципов обязательны
// Полная stateless архитектура
// Строгое следование стандартам
 
// RESTful практика - реальный мир
// Компромиссы ради производительности
// Адаптация под бизнес-требования
// Практичность важнее чистоты

// RESTful компромиссы
// Кеширование на клиенте (нарушение stateless)
localStorage.setItem('userToken', token);
 
// Batch операции (отход от единого интерфейса)
POST /api/users/batch-update
 
// Поиск с параметрами (гибкость URL)
GET /api/products?search=laptop&category=electronics

// Уровень 0 - Plain Old XML (POX)
POST /api/endpoint
// Один URL, один HTTP метод
 
// Уровень 1 - Ресурсы
GET /api/users
GET /api/products
// Множество URL, один HTTP метод
 
// Уровень 2 - HTTP методы
GET    /api/users     // ✅ RESTful начинается здесь
POST   /api/users
PUT    /api/users/123
DELETE /api/users/123
 
// Уровень 3 - HATEOAS
{
  "id": 123,
  "name": "John",
  "_links": {
    "self": "/api/users/123",
    "posts": "/api/users/123/posts"
  }
}

// ✅ RESTful URL структура
/api/v1/users                    // Коллекция
/api/v1/users/123               // Элемент
/api/v1/users/123/posts         // Вложенная коллекция
/api/v1/users/123/posts/456     // Вложенный элемент
 
// ❌ Не RESTful
/api/getUser?id=123
/api/createUser
/api/user_delete/123

// RESTful использование статус кодов
const responses = {
  200: 'OK - успешный GET, PUT',
  201: 'Created - успешный POST',
  204: 'No Content - успешный DELETE',
  400: 'Bad Request - ошибка клиента',
  401: 'Unauthorized - нет авторизации',
  404: 'Not Found - ресурс не найден',
  500: 'Internal Server Error - ошибка сервера'
};

// Инструменты для проверки RESTful API
// - Postman Collections
// - Swagger/OpenAPI
// - REST API validators
 
// Критерии оценки:
// ✅ Использует HTTP методы правильно
// ✅ Ресурсы в URL, не действия
// ✅ Правильные статус коды
// ✅ Единообразная структура ответов

// GraphQL - альтернатива RESTful
query {
  user(id: 123) {
    name
    posts {
      title
    }
  }
}
 
// gRPC - для высокопроизводительных API
// WebSocket - для real-time коммуникации

GET /api/deleteUser/123    // Действие в URL + неправильный метод
POST /api/users/getAll     // GET операция через POST

DELETE /api/users/123      // Правильный метод и ресурс
GET /api/users             // Правильный метод для получения