Что такое глобальный маршрут в FastAPI?

Что такое глобальный маршрут в FastAPI?

Глобальный маршрут в FastAPI — это маршрут, который определён непосредственно на объекте приложения (app) и обрабатывает запросы к определённому пути, часто к корневому пути '/' или ко всем путям с помощью шаблонов. Он позволяет централизованно обрабатывать запросы, например, для логирования, проверки аутентификации или возврата статических страниц.

Как создать глобальный маршрут?

Для создания глобального маршрута используется декоратор @app.get(), @app.post() или @app.api_route() с указанием пути. Например:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

@app.api_route("/{path:path}", methods=["GET", "POST"])
async def catch_all(path: str):
    return {"path": path}

В этом примере первый маршрут обрабатывает корневой путь, а второй — все остальные пути с любыми методами.

Где применяется?

Глобальные маршруты полезны для:

• Создания единой точки входа для API.
• Обработки ошибок 404 и перенаправлений.
• Реализации middleware-подобной логики без использования middleware.

Вывод

Глобальные маршруты в FastAPI удобны для централизованной обработки запросов, но для сложной логики лучше использовать middleware или APIRouter для модульности.