Бэкенд и FastAPI on kodkod | Вводный курс

Бэкенд и HTTP: кто что делает, методы и коды состояния

Mon, 01 Jan 0001 00:00:00 +0000

В этом уроке

Урок состоит из двух глав — в том же порядке, что и в презентации:

Глава 1 — что такое бэкенд: клиент, сервер, база данных, API и Endpoint
Глава 2 — методы HTTP и коды состояния

Глава 1: Что такое бэкенд — клиент, сервер, база данных, API и Endpoint

Что мы изучим?

Теперь мы переходим от программ, которые работают на нашем собственном компьютере, к программам, с которыми другие общаются по сети. Этот урок даёт общую картину и словарь:

FastAPI с нуля: установка, app = FastAPI(), первый маршрут и запуск сервера

Mon, 01 Jan 0001 00:00:00 +0000

Что мы изучим?

Этот урок — полная настройка с нуля настоящего сервера:

Виртуальное окружение (venv): куда устанавливаются библиотеки.
Установка FastAPI через pip.
main.py: импорт, создание app и первый маршрут (Route).
Запуск через uvicorn.
Проверка: браузер, curl и автоматическая страница документации /docs.

Зачем это нужно?

В теме сетей мы видели, что включает «ручной» сервер: bind, listen, accept и разбор текста. Это много работы, и легко упасть на плохом вводе. FastAPI делает всё это за нас: принимает запрос, разбирает HTTP, находит нужную функцию, превращает ответ в JSON и проверяет типы. Мы пишем только логику.

Параметры пути, параметры запроса и тело

Mon, 01 Jan 0001 00:00:00 +0000

Что мы изучим?

Клиенту нужно сказать серверу, что именно он хочет. Для этого есть три способа:

Способ	Где	Пример
Параметр пути (Path Parameter)	Часть самого пути	`/students/7`
Параметры запроса (Query Parameters)	После `?` в URL	`/students?city=Haifa&limit=10`
Тело (Body)	В теле запроса (JSON)	`{"name": "Dana", "age": 24}`

Зачем это нужно?

В следующем уроке мы напишем первый сервер, и в FastAPI каждый из трёх способов определяется по-своему. Если не понимать разницу, информация попадает не туда: идентификатор — в тело, а пароль — в URL. А каждый настоящий API, которым вы будете пользоваться (GitHub, погода, платежи), использует все три.

FastAPI: параметры пути, строка запроса, тело и HTTPException

Mon, 01 Jan 0001 00:00:00 +0000

Что мы изучим?

В предыдущем уроке функции вообще не получали ввода. Теперь они будут получать три вида, которые мы изучили:

Middleware: код, который выполняется при каждом запросе

Mon, 01 Jan 0001 00:00:00 +0000

Что мы изучим?

Какая возникает проблема, когда нужно что-то делать при каждом запросе.
Что такое Middleware и как оно связано с уже знакомым нам декоратором.
@app.middleware("http"), call_next, async и await.
Лог и измерение времени для каждого запроса в API студентов, а также заголовок, который добавляется к каждому ответу.

Зачем это нужно?

API студентов из предыдущего урока работает. Теперь мы хотим знать, что в нём происходит: какой запрос пришёл, какой код вернулся и сколько это заняло. Первый способ, который приходит в голову, — добавить строку лога в каждый маршрут: