Ответ
Принцип stateless (отсутствие состояния) — это ключевое ограничение архитектуры REST, которое означает, что сервер не хранит никакого контекста о клиенте между запросами.
Каждый запрос от клиента должен содержать всю информацию, необходимую для его выполнения. Сервер обрабатывает его изолированно, не полагаясь на предыдущие вызовы.
Почему это важно для REST?
Этот подход обеспечивает высокую масштабируемость и надежность системы. Любой экземпляр сервера может обработать любой запрос, что упрощает балансировку нагрузки и кэширование.
Пример: Аутентификация через JWT-токен
Клиент после логина получает токен и затем прикрепляет его к каждому последующему запросу. Сервер не хранит сессию, а просто валидирует токен при каждом обращении.
# Пример эндпоинта в FastAPI
from fastapi import FastAPI, Depends, Header, HTTPException
from pydantic import BaseModel
app = FastAPI()
# Функция для проверки токена, передаваемого в заголовке
async def verify_token(x_token: str = Header(...)):
if x_token != "fake-super-secret-token":
raise HTTPException(status_code=400, detail="X-Token header invalid")
return x_token
class Item(BaseModel):
name: str
# Каждый вызов этого эндпоинта требует наличия валидного токена
# Сервер не "помнит", что этот клиент уже обращался ранее
@app.post("/items/", dependencies=[Depends(verify_token)])
async def create_item(item: Item):
return {"item": item.name, "status": "created"}Ключевые преимущества
- Масштабируемость: Легко добавлять новые серверы без необходимости синхронизации состояния.
- Надежность: Отказ одного сервера не влияет на сеансы клиентов, так как запрос может быть перенаправлен на любой другой сервер.
- Простота: Упрощается архитектура сервера и его кэширование.