Skip to content

Latest commit

 

History

History
83 lines (51 loc) · 2.99 KB

README.md

File metadata and controls

83 lines (51 loc) · 2.99 KB

Урок 13. Веб-фреймворк FastAPI

Цель

Научиться создавать REST API (серверную часть) с помощью современного фреймворка FastAPI.

1. Что такое FastAPI?

FastAPI — это фреймворк для создания API. Он автоматически генерирует документацию (Swagger), проверяет данные через Pydantic и работает асинхронно.

Установка библиотек: pip install fastapi uvicorn

2. Минимальное приложение

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Привет, мир!"}

3. Запуск сервера

FastAPI нельзя запустить просто как скрипт (кнопкой ▶), потому что это веб-сервер, который должен работать постоянно.

В терминале перейди в папку с уроком и запусти uvicorn:

cd lesson-13-fastapi
python3 -m uvicorn main:app --reload
  • main — имя файла (main.py).
  • app — имя объекта FastAPI внутри файла.
  • --reload — автоматически перезапускает сервер при изменении кода.

4. Проверка работы

После успешного запуска в терминале появится: INFO: Uvicorn running on http://127.0.0.1:8000

Открой в браузере интерактивную документацию: http://127.0.0.1:8000/docs

Там ты увидишь все свои маршруты (Routes) и сможешь протестировать их прямо из браузера.

(Чтобы остановить сервер, нажми Ctrl+C в терминале).

5. Маршруты (Routes)

  • @app.get("/path") — получение данных.
  • @app.post("/path") — создание.
  • @app.put("/path") — обновление.
  • @app.delete("/path") — удаление.

6. Параметры пути и запроса

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

FastAPI сам преобразует item_id в число. Если пришла строка, вернется ошибка 422.

7. Модели Pydantic (Валидация)

from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float
    is_offer: bool = False

@app.post("/items/")
def create_item(item: Item):
    return {"item_name": item.name, "item_price": item.price}

Примеры

  • main.py — пример простого API с созданием, чтением, обновлением и удалением (CRUD).

Что дальше

Урок 14 — Архитектура проекта.