fastapi-expert - Асинхронный API на FastAPI и Python

Когда звать

• Когда API на FastAPI нужны схемы входа и ответа, проверка доступа и асинхронная база.
• Когда необходимо проверить коды HTTP, зависимости маршрутов и отражение API в OpenAPI.

Какие части API описывает FastAPI Expert

FastAPI Expert задаёт агенту работу со схемами Pydantic V2, асинхронными обработчиками, SQLAlchemy и зависимостями FastAPI. В область применения также входят JWT, OAuth2 и WebSocket. Прочитанный основной файл имеет версию 1.1.0.

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

Порядок реализации по исходнику

Сначала агент перечисляет маршруты, модели данных и требования к доступу. Затем проектирует схемы Pydantic и пишет async endpoints с внедрением зависимостей. После этого добавляет аутентификацию, авторизацию и ограничение частоты запросов, а результат проверяет через pytest и httpx.

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

В примере APIRouter задаёт префикс маршрутов. Сессия базы передаётся через Annotated и Depends. При повторной регистрации адреса пример возвращает HTTP 409, при создании записи - HTTP 201. Эти коды относятся к приведённому сценарию; другой проект должен выбрать их по своему контракту.

Асинхронная база и JWT

Раздел CRUD использует AsyncSession, запрос SQLAlchemy, сохранение и обновление записи после commit. В ограничениях запрещены синхронные операции базы и неправильное смешивание sync и async. При переносе обработчика полезно попросить агента показать не только async def, но и все вызываемые им операции ввода-вывода.

JWT-пример содержит срок действия токена, subject и обработку невалидных данных. Настоящий секрет должен приходить из настроек окружения. Исходник запрещает хранить пароли открытым текстом и выдавать чувствительные поля в ответах.

Автор требует синтаксис Pydantic V2, включая field_validator и model_config, и запрещает старые @validator и class Config. Учебные фрагменты следует проверять с установленной версией Pydantic, а не считать их готовым запускаемым приложением. Мы их не исполняли.

Задание для первого подключения

Можно начать с запроса: «Добавьте один маршрут с отдельными моделями входа и ответа. Проверьте неправильный ввод, отсутствие прав и повторную запись. Подмените внешние зависимости в тестах и покажите фактические результаты pytest». Это наш пример применения с ограниченной областью изменений.

В результате по инструкции нужны файлы схем, router, операции базы при необходимости и объяснение решений. Справочники по маршрутам, аутентификации, async SQLAlchemy и тестированию находятся в references; есть также указатель на перенос с Django.

QUICKSTART описывает подключение коллекции целиком. Мы проверили источники и MIT-лицензию, но не установку в Claude Code или Codex. Базовые типы и ошибки Python отдельно разбирает Python Pro.