В чем разница между HTTP и REST?

Разница между HTTP и REST

Это два разных уровня абстракции. HTTP — это протокол, REST — это архитектурный стиль. Часто их путают, поэтому разберу подробно.

HTTP (HyperText Transfer Protocol)

HTTP — это протокол прикладного уровня (Layer 7 в модели OSI). Он определяет, как отправлять и получать данные по сети. Основные характеристики:

# HTTP запрос содержит:
# - Метод (GET, POST, PUT, DELETE и т.д.)
# - URL
# - Заголовки (Headers)
# - Тело сообщения (Body, опционально)

import requests

# Простой HTTP запрос
response = requests.get('https://example.com/api/users')
print(response.status_code)  # 200, 404, 500 и т.д.
print(response.headers)

HTTP предоставляет:

• Методы: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD
• Коды ответов: 1xx, 2xx, 3xx, 4xx, 5xx
• Заголовки для метаданных
• Механизм кеширования
• Поддержку сессий (cookies)

REST (Representational State Transfer)

REST — это архитектурный стиль, созданный Roy Fielding. Это набор принципов и ограничений для проектирования веб-сервисов. REST можно реализовать на HTTP, но не обязательно.

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

1. Клиент-сервер архитектура — разделение ответственности
2. Statelessness — каждый запрос содержит всю необходимую информацию
3. Кешируемость — ответы должны быть помечены как кешируемые или нет
4. Единообразный интерфейс:
   • Ресурсы идентифицируются в запросе (URI)
   • Ресурсы манипулируются через представления (JSON, XML)
   • Сообщения являются самодокументируемыми
   • HATEOAS (Hypermedia As The Engine Of Application State)
5. Многоуровневая система — архитектура может состоять из иерархии слоёв
6. Code on demand (опционально) — сервер может расширить функциональность клиента

Пример правильного REST API на HTTP

from flask import Flask, jsonify, request

app = Flask(__name__)

# RESTful дизайн:
# GET /users       — получить список всех пользователей
# POST /users      — создать нового пользователя
# GET /users/id    — получить конкретного пользователя
# PUT /users/id    — обновить пользователя целиком
# PATCH /users/id  — частичное обновление
# DELETE /users/id — удалить пользователя

@app.route('/users', methods=['GET'])
def get_users():
    return jsonify([{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}])

@app.route('/users', methods=['POST'])
def create_user():
    data = request.json
    return jsonify({'id': 3, 'name': data['name']}), 201

@app.route('/users/<user_id>', methods=['GET'])
def get_user(user_id):
    return jsonify({'id': user_id, 'name': 'Alice'})

@app.route('/users/<user_id>', methods=['PUT'])
def update_user(user_id):
    data = request.json
    return jsonify({'id': user_id, 'name': data['name']})

@app.route('/users/<user_id>', methods=['DELETE'])
def delete_user(user_id):
    return '', 204

Практический пример: что НЕ является REST

# ❌ Это HTTP, но НЕ REST
# Глаголы в URL вместо методов
GET /api/get-user?id=1
GET /api/create-user
GET /api/delete-user?id=1

# ✅ Это REST
GET /api/users/1
POST /api/users
DELETE /api/users/1

Таблица сравнения

Вывод

HTTP — это как дорога. REST — это правила дорожного движения на этой дороге. Можно использовать HTTP без REST, но REST принципы предполагают использование HTTP правильно и эффективно. Хороший REST API на HTTP проще тестировать, масштабировать и поддерживать.