Thanks to visit codestin.com
Credit goes to github.com

Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/es/docs/advanced/additional-status-codes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Para conseguir esto importa `JSONResponse` y devuelve ahí directamente tu conte
{!../../../docs_src/additional_status_codes/tutorial001.py!}
```

/// warning | "Advertencia"
/// warning | Advertencia

Cuando devuelves directamente una `Response`, como en los ejemplos anteriores, será devuelta directamente.

Expand All @@ -28,7 +28,7 @@ Asegúrate de que la respuesta tenga los datos que quieras, y que los valores se

///

/// note | "Detalles Técnicos"
/// note | Detalles Técnicos

También podrías utilizar `from starlette.responses import JSONResponse`.

Expand Down
2 changes: 1 addition & 1 deletion docs/es/docs/advanced/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ El [Tutorial - Guía de Usuario](../tutorial/index.md){.internal-link target=_bl

En las secciones siguientes verás otras opciones, configuraciones, y características adicionales.

/// tip
/// tip | Consejo

Las próximas secciones **no son necesariamente "avanzadas"**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,13 @@ Deberías hacerlo después de adicionar todas tus *operaciones de path*.
{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```

/// tip | "Consejo"
/// tip | Consejo

Si llamas manualmente a `app.openapi()`, debes actualizar el `operationId`s antes de hacerlo.

///

/// warning | "Advertencia"
/// warning | Advertencia

Si haces esto, debes asegurarte de que cada una de tus *funciones de las operaciones de path* tenga un nombre único.

Expand Down
4 changes: 2 additions & 2 deletions docs/es/docs/advanced/response-directly.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Esto puede ser útil, por ejemplo, para devolver cookies o headers personalizado

De hecho, puedes devolver cualquier `Response` o cualquier subclase de la misma.

/// tip | "Consejo"
/// tip | Consejo

`JSONResponse` en sí misma es una subclase de `Response`.

Expand All @@ -38,7 +38,7 @@ Para esos casos, puedes usar el `jsonable_encoder` para convertir tus datos ante
{!../../../docs_src/response_directly/tutorial001.py!}
```

/// note | "Detalles Técnicos"
/// note | Detalles Técnicos

También puedes usar `from starlette.responses import JSONResponse`.

Expand Down
2 changes: 1 addition & 1 deletion docs/es/docs/advanced/response-headers.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Crea un response tal como se describe en [Retornar una respuesta directamente](r
{!../../../docs_src/response_headers/tutorial001.py!}
```

/// note | "Detalles Técnicos"
/// note | Detalles Técnicos

También podrías utilizar `from starlette.responses import Response` o `from starlette.responses import JSONResponse`.

Expand Down
2 changes: 1 addition & 1 deletion docs/es/docs/advanced/security/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

Hay algunas características adicionales para manejar la seguridad además de las que se tratan en el [Tutorial - Guía de Usuario: Seguridad](../../tutorial/security/index.md){.internal-link target=_blank}.

/// tip
/// tip | Consejo

Las siguientes secciones **no necesariamente son "avanzadas"**.

Expand Down
8 changes: 4 additions & 4 deletions docs/es/docs/async.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ async def read_results():
return results
```

/// note | "Nota"
/// note | Nota

Solo puedes usar `await` dentro de funciones creadas con `async def`.

Expand Down Expand Up @@ -138,7 +138,7 @@ Tú y esa persona 😍 se comen las hamburguesas 🍔 y la pasan genial ✨.

<img src="https://fastapi.tiangolo.com/img/async/concurrent-burgers/concurrent-burgers-07.png" alt="illustration">

/// info
/// info | Información

Las ilustraciones fueron creados por <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨

Expand Down Expand Up @@ -204,7 +204,7 @@ Sólo las comes y listo 🍔 ⏹.

No has hablado ni coqueteado mucho, ya que has pasado la mayor parte del tiempo esperando 🕙 frente al mostrador 😞.

/// info
/// info | Información

Las ilustraciones fueron creados por <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨

Expand Down Expand Up @@ -396,7 +396,7 @@ Todo eso es lo que impulsa FastAPI (a través de Starlette) y lo que hace que te

## Detalles muy técnicos

/// warning | "Advertencia"
/// warning | Advertencia

Probablemente puedas saltarte esto.

Expand Down
4 changes: 2 additions & 2 deletions docs/es/docs/deployment/versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Siguiendo las convenciones de *Semantic Versioning*, cualquier versión por deba

FastAPI también sigue la convención de que cualquier cambio hecho en una <abbr title="versiones de parche">"PATCH" version</abbr> es para solucionar errores y <abbr title="cambios que no rompan funcionalidades o compatibilidad">*non-breaking changes*</abbr>.

/// tip
/// tip | Consejo

El <abbr title="parche">"PATCH"</abbr> es el último número, por ejemplo, en `0.2.3`, la <abbr title="versiones de parche">PATCH version</abbr> es `3`.

Expand All @@ -56,7 +56,7 @@ fastapi>=0.45.0,<0.46.0

En versiones <abbr title="versiones menores">"MINOR"</abbr> son añadidas nuevas características y posibles <abbr title="Cambios que rompen posibles funcionalidades o compatibilidad">breaking changes</abbr>.

/// tip
/// tip | Consejo

La versión "MINOR" es el número en el medio, por ejemplo, en `0.2.3`, la <abbr title="versión menor">"MINOR" version</abbr> es `2`.

Expand Down
2 changes: 1 addition & 1 deletion docs/es/docs/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ second_user_data = {
my_second_user: User = User(**second_user_data)
```

/// info
/// info | Información

`**second_user_data` significa:

Expand Down
4 changes: 2 additions & 2 deletions docs/es/docs/how-to/graphql.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Como **FastAPI** está basado en el estándar **ASGI**, es muy fácil integrar c

Puedes combinar *operaciones de path* regulares de la library de FastAPI con GraphQL en la misma aplicación.

/// tip
/// tip | Consejo

**GraphQL** resuelve algunos casos de uso específicos.

Expand Down Expand Up @@ -49,7 +49,7 @@ Versiones anteriores de Starlette incluyen la clase `GraphQLApp` para integrarlo

Esto fue marcado como obsoleto en Starlette, pero si aún tienes código que lo usa, puedes fácilmente **migrar** a <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a>, la cual cubre el mismo caso de uso y tiene una **interfaz casi idéntica.**

/// tip
/// tip | Consejo

Si necesitas GraphQL, te recomendaría revisar <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a>, que es basada en anotaciones de tipo en vez de clases y tipos personalizados.

Expand Down
6 changes: 3 additions & 3 deletions docs/es/docs/python-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Todo **FastAPI** está basado en estos type hints, lo que le da muchas ventajas

Pero, así nunca uses **FastAPI** te beneficiarás de aprender un poco sobre los type hints.

/// note | "Nota"
/// note | Nota

Si eres un experto en Python y ya lo sabes todo sobre los type hints, salta al siguiente capítulo.

Expand Down Expand Up @@ -256,7 +256,7 @@ Tomado de la documentación oficial de Pydantic:
{!../../../docs_src/python_types/tutorial010.py!}
```

/// info | "Información"
/// info | Información

Para aprender más sobre <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic mira su documentación</a>.

Expand Down Expand Up @@ -288,7 +288,7 @@ Puede que todo esto suene abstracto. Pero no te preocupes que todo lo verás en

Lo importante es que usando los tipos de Python estándar en un único lugar (en vez de añadir más clases, decorator, etc.) **FastAPI** hará mucho del trabajo por ti.

/// info | "Información"
/// info | Información

Si ya pasaste por todo el tutorial y volviste a la sección de los tipos, una buena referencia es <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">la "cheat sheet" de `mypy`</a>.

Expand Down
16 changes: 8 additions & 8 deletions docs/es/docs/tutorial/cookie-params.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,9 @@ Primero importa `Cookie`:

//// tab | Python 3.10+ non-Annotated

/// tip
/// tip | Consejo

Prefer to use the `Annotated` version if possible.
Es preferible utilizar la versión `Annotated` si es posible.

///

Expand All @@ -46,9 +46,9 @@ Prefer to use the `Annotated` version if possible.

//// tab | Python 3.8+ non-Annotated

/// tip
/// tip | Consejo

Prefer to use the `Annotated` version if possible.
Es preferible utilizar la versión `Annotated` si es posible.

///

Expand Down Expand Up @@ -90,9 +90,9 @@ El primer valor es el valor por defecto, puedes pasar todos los parámetros adic

//// tab | Python 3.10+ non-Annotated

/// tip
/// tip | Consejo

Prefer to use the `Annotated` version if possible.
Es preferible utilizar la versión `Annotated` si es posible.

///

Expand All @@ -104,9 +104,9 @@ Prefer to use the `Annotated` version if possible.

//// tab | Python 3.8+ non-Annotated

/// tip
/// tip | Consejo

Prefer to use the `Annotated` version if possible.
Es preferible utilizar la versión `Annotated` si es posible.

///

Expand Down
12 changes: 6 additions & 6 deletions docs/es/docs/tutorial/first-steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ $ uvicorn main:app --reload

</div>

/// note | "Nota"
/// note | Nota

El comando `uvicorn main:app` se refiere a:

Expand Down Expand Up @@ -139,7 +139,7 @@ También podrías usarlo para generar código automáticamente, para los cliente

`FastAPI` es una clase de Python que provee toda la funcionalidad para tu API.

/// note | "Detalles Técnicos"
/// note | Detalles Técnicos

`FastAPI` es una clase que hereda directamente de `Starlette`.

Expand Down Expand Up @@ -205,7 +205,7 @@ https://example.com/items/foo
/items/foo
```

/// info | "Información"
/// info | Información

Un "path" también se conoce habitualmente como "endpoint", "route" o "ruta".

Expand Down Expand Up @@ -259,7 +259,7 @@ El `@app.get("/")` le dice a **FastAPI** que la función que tiene justo debajo
* el path `/`
* usando una <abbr title="an HTTP GET method">operación <code>get</code></abbr>

/// info | "Información sobre `@decorator`"
/// info | Información sobre `@decorator`

Esa sintaxis `@algo` se llama un "decorador" en Python.

Expand All @@ -286,7 +286,7 @@ y las más exóticas:
* `@app.patch()`
* `@app.trace()`

/// tip | "Consejo"
/// tip | Consejo

Tienes la libertad de usar cada operación (método de HTTP) como quieras.

Expand Down Expand Up @@ -324,7 +324,7 @@ También podrías definirla como una función estándar en lugar de `async def`:
{!../../../docs_src/first_steps/tutorial003.py!}
```

/// note | "Nota"
/// note | Nota

Si no sabes la diferencia, revisa el [Async: *"¿Tienes prisa?"*](../async.md#tienes-prisa){.internal-link target=_blank}.

Expand Down
16 changes: 8 additions & 8 deletions docs/es/docs/tutorial/path-params.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Puedes declarar el tipo de un parámetro de path en la función usando las anota

En este caso, `item_id` es declarado como un `int`.

/// check | "Revisa"
/// check | Revisa

Esto te dará soporte en el editor dentro de tu función, con chequeo de errores, auto-completado, etc.

Expand All @@ -38,7 +38,7 @@ Si corres este ejemplo y abres tu navegador en <a href="http://127.0.0.1:8000/it
{"item_id":3}
```

/// check | "Revisa"
/// check | Revisa

Observa que el valor que recibió (y devolvió) tu función es `3`, como un Python `int`, y no un string `"3"`.

Expand Down Expand Up @@ -69,7 +69,7 @@ debido a que el parámetro de path `item_id` tenía el valor `"foo"`, que no es

El mismo error aparecería si pasaras un `float` en vez de un `int` como en: <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>

/// check | "Revisa"
/// check | Revisa

Así, con la misma declaración de tipo de Python, **FastAPI** te da validación de datos.

Expand All @@ -85,7 +85,7 @@ Cuando abras tu navegador en <a href="http://127.0.0.1:8000/docs" class="externa

<img src="/img/tutorial/path-params/image01.png">

/// check | "Revisa"
/// check | Revisa

Nuevamente, con la misma declaración de tipo de Python, **FastAPI** te da documentación automática e interactiva (integrándose con Swagger UI)

Expand Down Expand Up @@ -143,13 +143,13 @@ Luego crea atributos de clase con valores fijos, que serán los valores disponib
{!../../../docs_src/path_params/tutorial005.py!}
```

/// info | "Información"
/// info | Información

Las <a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">Enumerations (o enums) están disponibles en Python</a> desde la versión 3.4.

///

/// tip | "Consejo"
/// tip | Consejo

Si lo estás dudando, "AlexNet", "ResNet", y "LeNet" son solo nombres de <abbr title="Técnicamente, arquitecturas de modelos de Deep Learning">modelos</abbr> de Machine Learning.

Expand Down Expand Up @@ -189,7 +189,7 @@ Puedes obtener el valor exacto (un `str` en este caso) usando `model_name.value`
{!../../../docs_src/path_params/tutorial005.py!}
```

/// tip | "Consejo"
/// tip | Consejo

También podrías obtener el valor `"lenet"` con `ModelName.lenet.value`.

Expand Down Expand Up @@ -246,7 +246,7 @@ Entonces lo puedes usar con:
{!../../../docs_src/path_params/tutorial004.py!}
```

/// tip | "Consejo"
/// tip | Consejo

Podrías necesitar que el parámetro contenga `/home/johndoe/myfile.txt` con un slash inicial (`/`).

Expand Down
6 changes: 3 additions & 3 deletions docs/es/docs/tutorial/query-params.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,13 @@ Del mismo modo puedes declarar parámetros de query opcionales definiendo el val

En este caso el parámetro de la función `q` será opcional y será `None` por defecto.

/// check | "Revisa"
/// check | Revisa

También puedes notar que **FastAPI** es lo suficientemente inteligente para darse cuenta de que el parámetro de path `item_id` es un parámetro de path y que `q` no lo es, y por lo tanto es un parámetro de query.

///

/// note | "Nota"
/// note | Nota

FastAPI sabrá que `q` es opcional por el `= None`.

Expand Down Expand Up @@ -199,7 +199,7 @@ En este caso hay 3 parámetros de query:
* `skip`, un `int` con un valor por defecto de `0`.
* `limit`, un `int` opcional.

/// tip | "Consejo"
/// tip | Consejo

También podrías usar los `Enum`s de la misma manera que con los [Parámetros de path](path-params.md#valores-predefinidos){.internal-link target=_blank}.

Expand Down