В чем разница между RESTful API и RPC?

RESTful API vs RPC: архитектурные парадигмы

Это два принципиально разных подхода к построению веб-сервисов. Каждый имеет свои преимущества и недостатки, выбор зависит от требований проекта.

RPC (Remote Procedure Call)

RPC — это парадигма, когда клиент вызывает функцию на удалённом сервере, как если бы она была локальной. Сервер выполняет функцию и возвращает результат.

Характеристики:

• Ориентирован на функции/действия (методы)
• URL содержит имя метода: /api/getUserById, /api/updateUser
• Обычно использует один метод (часто POST)
• Простой для понимания и реализации
• Требует документации для каждого метода

# Пример RPC запросов
POST /api/getUser?id=123
POST /api/createUser
POST /api/deleteUser?id=123
POST /api/updateUserEmail?id=123&email=new@example.com

RESTful API (Representational State Transfer)

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

Характеристики:

• Ориентирован на ресурсы (существительные)
• URL содержит ресурс: /api/users/{id}, /api/posts/{id}/comments
• Использует HTTP методы (GET, POST, PUT, DELETE, PATCH)
• Более структурирован и предсказуем
• Самодокументируется через HTTP методы

# Пример REST запросов
GET /api/users/123              # Получить пользователя
POST /api/users                 # Создать пользователя
PUT /api/users/123              # Обновить полностью
PATCH /api/users/123            # Обновить частично
DELETE /api/users/123           # Удалить пользователя

Сравнительная таблица

Примеры реализации на Python с Flask

RPC подход:

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/api/getUser", methods=["POST"])
def get_user():
    user_id = request.json.get("id")
    user = {"id": user_id, "name": "John"}
    return jsonify(user)

@app.route("/api/createUser", methods=["POST"])
def create_user():
    data = request.json
    return jsonify({"id": 1, **data})

REST подход:

from flask import Flask, request, jsonify
from flask_restful import Api, Resource

app = Flask(__name__)
api = Api(app)

class User(Resource):
    def get(self, user_id):
        return {"id": user_id, "name": "John"}, 200
    
    def post(self):
        data = request.json
        return {"id": 1, **data}, 201
    
    def put(self, user_id):
        data = request.json
        return {"id": user_id, **data}, 200
    
    def delete(self, user_id):
        return {"message": "Deleted"}, 204

api.add_resource(User, "/api/users/<int:user_id>")
api.add_resource(User, "/api/users")

Кэширование — ключевая разница

RPC:

# POST запросы не кэшируются браузерами и proxy
POST /api/getUser  # Каждый раз идет на сервер

REST:

# GET запросы автоматически кэшируются
GET /api/users/123  # Может использовать кэш

Когда использовать что

REST предпочтительнее для:

• Публичных API
• Когда важно кэширование
• Стандартных CRUD операций
• Команд, знающих REST

RPC может быть полезен для:

• Сложных операций, не описываемых ресурсами
• Внутренних микросервисов
• Когда нужна простота реализации
• GraphQL альтернатив

Заключение

REST — это современный стандарт для публичных API. Он лучше масштабируется, имеет встроенное кэширование и более предсказуем. RPC проще в реализации, но менее структурирован. В современной разработке REST является предпочтительным выбором для большинства приложений.