committed by
GitHub
1 changed files with 97 additions and 0 deletions
@ -0,0 +1,97 @@ |
|||||
|
# Parámetros de Cookie |
||||
|
|
||||
|
Puedes definir parámetros de Cookie de la misma manera que defines parámetros de `Query` y `Path`. |
||||
|
|
||||
|
## Importar `Cookie` |
||||
|
|
||||
|
Primero importa `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+ non-Annotated" |
||||
|
|
||||
|
!!! tip |
||||
|
Prefer to use the `Annotated` version if possible. |
||||
|
|
||||
|
```Python hl_lines="1" |
||||
|
{!> ../../../docs_src/cookie_params/tutorial001_py310.py!} |
||||
|
``` |
||||
|
|
||||
|
=== "Python 3.8+ non-Annotated" |
||||
|
|
||||
|
!!! tip |
||||
|
Prefer to use the `Annotated` version if possible. |
||||
|
|
||||
|
```Python hl_lines="3" |
||||
|
{!> ../../../docs_src/cookie_params/tutorial001.py!} |
||||
|
``` |
||||
|
|
||||
|
## Declarar parámetros de `Cookie` |
||||
|
|
||||
|
Luego declara los parámetros de cookie usando la misma estructura que con `Path` y `Query`. |
||||
|
|
||||
|
El primer valor es el valor por defecto, puedes pasar todos los parámetros adicionales de validación o anotación: |
||||
|
|
||||
|
=== "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+ non-Annotated" |
||||
|
|
||||
|
!!! tip |
||||
|
Prefer to use the `Annotated` version if possible. |
||||
|
|
||||
|
```Python hl_lines="7" |
||||
|
{!> ../../../docs_src/cookie_params/tutorial001_py310.py!} |
||||
|
``` |
||||
|
|
||||
|
=== "Python 3.8+ non-Annotated" |
||||
|
|
||||
|
!!! tip |
||||
|
Prefer to use the `Annotated` version if possible. |
||||
|
|
||||
|
```Python hl_lines="9" |
||||
|
{!> ../../../docs_src/cookie_params/tutorial001.py!} |
||||
|
``` |
||||
|
|
||||
|
!!! note "Detalles Técnicos" |
||||
|
`Cookie` es una clase "hermana" de `Path` y `Query`. También hereda de la misma clase común `Param`. |
||||
|
|
||||
|
Pero recuerda que cuando importas `Query`, `Path`, `Cookie` y otros de `fastapi`, en realidad son funciones que devuelven clases especiales. |
||||
|
|
||||
|
!!! info |
||||
|
Para declarar cookies, necesitas usar `Cookie`, porque de lo contrario los parámetros serían interpretados como parámetros de query. |
||||
|
|
||||
|
## Resumen |
||||
|
|
||||
|
Declara cookies con `Cookie`, usando el mismo patrón común que `Query` y `Path`. |
Loading…
Reference in new issue