Skip to content

От переводчика

Это машинный перевод (DeepSeek) статьи https://fastapi.tiangolo.com/tutorial/cookie-params/

Версия от 03.09.2026

По этой теме хочу также рекомендовать своё дополнение в канале Макс. В нём пример из урока доведён до рабочего состояния в Swagger UI и рассмотрены более близкие к практике случаи.

Подпишитесь на канал "Изучаем FastAPI", чтобы ссылки на разбор сложных моментов работали.

Подпишитесь на канал "Первод курса FastAPI", чтобы не пропустить новые переводы.

 

Перевод прочих разделов документации буду по мере сил делать.

Обо мне

Параметры Cookie

Вы можете определять параметры Cookie так же, как определяете параметры Query и Path.

Сначала импортируйте Cookie:

from typing import Annotated

from fastapi import Cookie, FastAPI

app = FastAPI()


@app.get("/items/")
async def read_items(ads_id: Annotated[str | None, Cookie()] = None):
    return {"ads_id": ads_id}
🤓 Другие версии и варианты

Совет

По возможности предпочитайте версию с Annotated.

from fastapi import Cookie, FastAPI

app = FastAPI()


@app.get("/items/")
async def read_items(ads_id: str | None = Cookie(default=None)):
    return {"ads_id": ads_id}

Затем объявите параметры cookie, используя ту же структуру, что и с Path и Query.

Вы можете определить значение по умолчанию, а также все дополнительные параметры валидации или аннотации:

from typing import Annotated

from fastapi import Cookie, FastAPI

app = FastAPI()


@app.get("/items/")
async def read_items(ads_id: Annotated[str | None, Cookie()] = None):
    return {"ads_id": ads_id}
🤓 Другие версии и варианты

Совет

По возможности предпочитайте версию с Annotated.

from fastapi import Cookie, FastAPI

app = FastAPI()


@app.get("/items/")
async def read_items(ads_id: str | None = Cookie(default=None)):
    return {"ads_id": ads_id}

Технические детали

Cookie — это «сестринский» класс Path и Query. Он также наследуется от того же общего класса Param.

Но помните, что когда вы импортируете Query, Path, Cookie и другие из fastapi, на самом деле это функции, возвращающие специальные классы.

Примечание

Чтобы объявить cookies, вам нужно использовать Cookie, иначе параметры будут интерпретированы как параметры запроса.

Примечание

Имейте в виду, что, поскольку браузеры обрабатывают cookies особым образом и за кулисами, они не легко позволяют JavaScript касаться их.

Если вы перейдёте в интерфейс документации API по адресу /docs, вы сможете увидеть документацию для cookies для ваших операций пути.

Но даже если вы заполните данные и нажмёте «Execute», поскольку интерфейс документации работает на JavaScript, cookies не будут отправлены, и вы увидите сообщение об ошибке, как будто вы не вводили никаких значений.

Итог

Объявляйте cookies с помощью Cookie, используя тот же общий шаблон, что и Query и Path.