FastAPI не навязывает схему версионирования API. Это свобода, за которую платят ломающимися интеграциями у клиентов. Разбираем четыре подхода — от префикса в URL до заголовков — и показываем, чем каждый оборачивается на практике.
Когда эндпоинтов становится за сотню, автогенерированная документация FastAPI превращается из удобного инструмента в неуправляемую стену текстов. Разбираем, как вернуть ей читаемость: теги, роутеры, кастомизация OpenAPI-схемы и типичные ловушки.
Писать эндпоинты в FastAPI быстро, а вот покрывать их тестами — уже не так очевидно. Разберём, как устроен тестовый клиент, зачем подменять зависимости и почему тесты на реальной базе ломаются в CI чаще, чем в локальном терминале.
В FastAPI нет встроенной системы авторизации «из коробки» — фреймворк даёт примитивы, а собирать из них решение приходится самостоятельно. Разбираем четыре подхода: от простейшего API-ключа до OAuth2-провайдера, с конкретными фрагментами кода и таблицей, чтобы выбрать нужный за пять минут.
BackgroundTasks в FastAPI выглядят как простой способ отложить работу после ответа клиенту. На практике задачи теряются при перезапуске, блокируют event loop и молча падают без логов. Разбираем, как использовать встроенный механизм правильно и когда пора переходить на Celery или arq.
Приём файлов через API — задача, которая выглядит тривиально до первой утечки памяти на большом аплоаде. Разбираем рабочий эндпоинт на FastAPI 0.115.x: от простого UploadFile до потоковой записи, валидации и типичных ошибок.
FastAPI из коробки отдаёт 422 на невалидный запрос и 500 на необработанное исключение — и оба ответа часто бесполезны для клиента. Разбираем, как выстроить обработку ошибок так, чтобы фронтенд получал понятные сообщения, логи не превращались в кашу, а пользователь не видел трейсбек.
Middleware в FastAPI выглядит просто — декоратор, пара строк, и вот у вас логирование, CORS и замер времени. Но под нагрузкой промежуточный слой способен удвоить latency и создать проблемы, которые не видны на локальной машине. Разбираем реальный кейс: почему middleware на базе BaseHTTPMiddleware читал тело запроса дважды и как это починили без отказа от ASGI-стека.
Dependency Injection в FastAPI — не просто способ передать объект в эндпоинт. Разбираем приёмы, которые экономят код, и ошибки, которые превращают проект в неуправляемый клубок: вложенные цепочки, области жизни, тестируемость и реальную цену неправильного scope.
Flask-приложение выросло, и вы решили переехать на FastAPI ради асинхронности и автодокументации. Разбираем реальные отличия в роутинге, DI, валидации и работе с базой — и показываем, чем за это придётся заплатить.
У Flask больше двух тысяч расширений на PyPI, и новичок ставит их пачками «на всякий случай». Разбираем на примере типичного API-сервиса, какие расширения решают реальные задачи, какие дублируют друг друга, и чем вы платите за каждое лишнее.
Blueprints в Flask обещают модульность, но на практике приводят к циклическим импортам, потерянным шаблонам и нечитаемой фабрике приложения. Разбираем пять конкретных ошибок — с кодом, который их воспроизводит, и кодом, который их исправляет.