Метод trace класса APIRouter
Метод trace применяется к объекту роутера
APIRouter
и вешает функцию на TRACE-запрос.
Первым параметром передаётся путь URL.
Вторым и последующими параметрами могут идти зависимости,
теги, статус-коды и другие настройки маршрута.
Функция-обработчик возвращает словарь, список или модель,
которые FastAPI отдаёт клиенту.
TRACE-метод обычно используется для диагностики:
сервер возвращает клиенту полученный запрос целиком.
Синтаксис
router.trace(path)
Пример
Давайте создадим роутер и повесим обработчик на адрес '/trace':
from fastapi import FastAPI, APIRouter
app = FastAPI()
router = APIRouter()
@router.trace('/trace')
def trace_handler():
return {'method': 'TRACE'}
app.include_router(router)
Результат выполнения кода:
{"method": "TRACE"}
Пример
Давайте примем параметр name из URL внутри роутера:
from fastapi import FastAPI, APIRouter
app = FastAPI()
router = APIRouter(prefix='/api')
@router.trace('/user/{name}')
def user_trace(name: str):
return {'name': name, 'method': 'TRACE'}
app.include_router(router)
Результат выполнения кода для адреса /api/user/abcde:
{"name": "abcde", "method": "TRACE"}
