POST-запросы и Pydantic

Бытовая аналогия: бланк на паспортном контроле

Когда вы заполняете бланк (анкету) на границе, в нём заранее указано: «Имя — буквами», «Возраст — числом», «Email — необязательно». Сотрудник не пропустит бланк, где в графе «возраст» написано «двадцать пять» словами.

Pydantic-модель — это и есть такой бланк. Вы описываете, какие поля нужны и какого они типа, а FastAPI берёт на себя роль строгого пограничника: проверяет каждый присланный JSON и сам отклоняет неправильный, не пуская «битые» данные в вашу логику.

Pydantic — модели данных

Чтобы принимать данные (например, нового пользователя), описывают модель — классШаблон для создания объектов: описывает их данные (атрибуты) и поведение (методы). с типами полей. FastAPI сам проверит, что клиент прислал корректные данные, иначе вернёт понятную ошибку.

Модель — это знакомый вам класс, унаследованный от BaseModel (вспомните модуль про ООП и @dataclass — идея та же).

Разбор. Клиент прислал возраст строкой "25". int("25") превращает её в число 25, поэтому age + 1 даёт 26, и вывод — Виктор, через год будет 26. Pydantic делает такое приведение и проверку автоматически: если бы пришло "двадцать", он вернул бы клиенту ошибку 422.

Как это работает

Клиент шлёт POST-запрос с JSON-телом:

FastAPI автоматически:

• разберёт JSON и превратит его в объектКонкретный экземпляр класса — со своими данными. Почти всё в Python является объектом. User;
• проверит, что name — строкаТекстовое значение в кавычках: "привет". Неизменяема. По-английски string (str)., а age — число;
• если данные неверные — сам вернёт ошибку 422 с описанием, что не так.

Мини-приложение: список задач

Соберём всё вместе — крошечный REST API для спискаИзменяемая упорядоченная коллекция элементов: [1, 2, 3]. По-английски list. дел (хранение в памяти):

⚠️ Частые ошибки новичков

• Забывают аннотацию типа у параметра-тела. Если написать def create_user(user): без : User, FastAPI не поймёт, что это тело запроса.
• Шлют POST без тела. Эндпоинт ждёт JSON с полями модели — пустой запрос вернёт 422 со списком недостающих полей.
• Возвращают объект модели и удивляются. Лучше вернуть dict (или todo.dict()) — FastAPI сериализует его в JSON.