fastapi/docs/ko/docs/tutorial/cookie-params.md

2.7 KiB

쿠키 매개변수

쿠키 매개변수를 QueryPath 매개변수들과 같은 방식으로 정의할 수 있습니다.

먼저 Cookie를 임포트합니다:

=== "Python 3.10+"

```Python hl_lines="3"
{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
```

=== "Python 3.9+"

```Python hl_lines="3"
{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
```

=== "Python 3.8+"

```Python hl_lines="3"
{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
```

=== "Python 3.10+ Annotated가 없는 경우"

!!! tip "팁"
    가능하다면 `Annotated`가 달린 버전을 권장합니다.

```Python hl_lines="1"
{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
```

=== "Python 3.8+ Annotated가 없는 경우"

!!! tip "팁"
    가능하다면 `Annotated`가 달린 버전을 권장합니다.

```Python hl_lines="3"
{!> ../../../docs_src/cookie_params/tutorial001.py!}
```

그런 다음, PathQuery처럼 동일한 구조를 사용하는 쿠키 매개변수를 선언합니다.

첫 번째 값은 기본값이며, 추가 검증이나 어노테이션 매개변수 모두 전달할 수 있습니다:

=== "Python 3.10+"

```Python hl_lines="9"
{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
```

=== "Python 3.9+"

```Python hl_lines="9"
{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
```

=== "Python 3.8+"

```Python hl_lines="10"
{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
```

=== "Python 3.10+ Annotated가 없는 경우"

!!! tip "팁"
    가능하다면 `Annotated`가 달린 버전을 권장합니다.

```Python hl_lines="7"
{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
```

=== "Python 3.8+ Annotated가 없는 경우"

!!! tip "팁"
    가능하다면 `Annotated`가 달린 버전을 권장합니다.

```Python hl_lines="9"
{!> ../../../docs_src/cookie_params/tutorial001.py!}
```

!!! note "기술 세부사항" CookiePathQuery의 "자매"클래스입니다. 이 역시 동일한 공통 Param 클래스를 상속합니다.

`Query`, `Path`, `Cookie` 그리고 다른 것들은 `fastapi`에서 임포트 할 때, 실제로는 특별한 클래스를 반환하는 함수임을 기억하세요.

!!! info "정보" 쿠키를 선언하기 위해서는 Cookie를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.

요약

CookieQuery, Path와 동일한 패턴을 사용하여 선언합니다.