From 4a377cfabb0813825dbf68c685d1b8e611c4e3c8 Mon Sep 17 00:00:00 2001
From: TheHandyOwl <24987271+TheHandyOwl@users.noreply.github.com>
Date: Wed, 15 Jan 2025 23:37:51 +0100
Subject: [PATCH] Translation EN > ES: request.es.md (#1051)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

NEW: translation EN (current request.md file) to ES (new request.es.md
file)

---------

Co-authored-by: Ale Mohamad ⌘ <alejandro.mohamad@gmail.com>
---
 docs/advanced/request.es.md | 65 +++++++++++++++++++++++++++++++++++++
 docs/advanced/request.md    |  3 +-
 mkdocs.yml                  |  1 +
 3 files changed, 67 insertions(+), 2 deletions(-)
 create mode 100644 docs/advanced/request.es.md

diff --git a/docs/advanced/request.es.md b/docs/advanced/request.es.md
new file mode 100644
index 000000000..abbd96fc5
--- /dev/null
+++ b/docs/advanced/request.es.md
@@ -0,0 +1,65 @@
+# Solicitud (Request)
+
+El objeto [`Request`](https://api.vapor.codes/vapor/documentation/vapor/request) (solicitud) se pasa a cada [controlador de ruta](../basics/routing.md).
+
+```swift
+app.get("hello", ":name") { req -> String in
+    let name = req.parameters.get("name")!
+    return "Hello, \(name)!"
+}
+```
+
+Es la ventana principal al resto de la funcionalidad de Vapor. Contiene APIs para el [cuerpo de la solicitud](../basics/content.md), [parámetros de consulta](../basics/content.md#query), [logger](../basics/logging.md), [cliente HTTP](../basics/client.md), [Autenticador](../security/authentication.md) y más. Accediendo a esta funcionalidad a través de la solicitud, se mantiene el cálculo en el bucle de eventos correcto y permite simularla para realizar pruebas. Incluso puedes añadir tus propios [servicios](../advanced/services.md) a la `Request` con extensiones.
+
+La documentación completa de la API para `Request` se puede encontrar [aquí](https://api.vapor.codes/vapor/documentation/vapor/request).
+
+## Aplicación
+
+La propiedad `Request.application` contiene una referencia a [`Application`](https://api.vapor.codes/vapor/documentation/vapor/application). Este objeto contiene toda la configuración y la funcionalidad central de la aplicación. La mayor parte solo se debe configurar en `configure.swift`, antes de que la aplicación se inicie por completo, y muchas de las APIs de bajo nivel no serán necesarias en la mayoría de las aplicaciones. Una de las propiedades más útiles es `Application.eventLoopGroup`, que se puede utilizar para obtener un `EventLoop` para los procesos que necesitan uno nuevo a través del método `any()`. También contiene [`Environment`](../basics/environment.md).
+
+## Body
+
+Si quieres acceder directamente al cuerpo de la solicitud como un `ByteBuffer`, puedes utilizar `Request.body.data`. Esto puede utilizarse para transmitir datos desde el cuerpo de la solicitud a un archivo (aunque para esto deberías utilizar la propiedad [`fileio`](../advanced/files.md) en la solicitud) o a otro cliente HTTP.
+
+## Cookies
+
+Aunque la aplicación más útil de las cookies es a través de las [sesiones](../advanced/sessions.md#configuration) integradas, también puedes acceder a las cookies directamente a través de `Request.cookies`.
+
+```swift
+app.get("my-cookie") { req -> String in
+    guard let cookie = req.cookies["my-cookie"] else {
+        throw Abort(.badRequest)
+    }
+    if let expiration = cookie.expires, expiration < Date() {
+        throw Abort(.badRequest)
+    }
+    return cookie.string
+}
+```
+
+## Cabeceras
+
+Se puede acceder a un objeto `HTTPHeaders` en `Request.headers`. Contiene todas las cabeceras (headers) enviadas con la solicitud. Se puede utilizar para acceder a la cabecera `Content-Type`, por ejemplo.
+
+```swift
+app.get("json") { req -> String in
+    guard let contentType = req.headers.contentType, contentType == .json else {
+        throw Abort(.badRequest)
+    }
+    return "JSON"
+}
+```
+
+Consulta más documentación sobre `HTTPHeaders` [aquí](https://swiftpackageindex.com/apple/swift-nio/2.56.0/documentation/niohttp1/httpheaders). Vapor también añade varias extensiones a `HTTPHeaders` para facilitar el trabajo con las cabeceras más utilizadas; la lista está disponible [aquí](https://api.vapor.codes/vapor/documentation/vapor/niohttp1/httpheaders#instance-properties)
+
+## Dirección IP
+
+Puedes acceder a la `SocketAddress` que representa al cliente a través de `Request.remoteAddress`, que puede ser útil para el registro o la limitación de velocidad utilizando la representación de la cadena `Request.remoteAddress.ipAddress`. Puede que no represente con exactitud la dirección IP del cliente si la aplicación está detrás de un reverse proxy.
+
+```swift
+app.get("ip") { req -> String in
+    return req.remoteAddress.ipAddress
+}
+```
+
+Consulta más documentación sobre `SocketAddress` [aquí](https://swiftpackageindex.com/apple/swift-nio/2.56.0/documentation/niocore/socketaddress).
diff --git a/docs/advanced/request.md b/docs/advanced/request.md
index 6f3ed73e2..15ef79d0d 100644
--- a/docs/advanced/request.md
+++ b/docs/advanced/request.md
@@ -49,6 +49,7 @@ app.get("json") { req -> String in
     return "JSON"
 }
 ```
+
 See further documentation for `HTTPHeaders` [here](https://swiftpackageindex.com/apple/swift-nio/2.56.0/documentation/niohttp1/httpheaders). Vapor also adds several extensions to `HTTPHeaders` to make working with the most commonly-used headers easier; a list is available [here](https://api.vapor.codes/vapor/documentation/vapor/niohttp1/httpheaders#instance-properties)
 
 ## IP Address
@@ -62,5 +63,3 @@ app.get("ip") { req -> String in
 ```
 
 See further documentation for `SocketAddress` [here](https://swiftpackageindex.com/apple/swift-nio/2.56.0/documentation/niocore/socketaddress).
-
-
diff --git a/mkdocs.yml b/mkdocs.yml
index 64e83cd19..7dd47238e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -365,6 +365,7 @@ plugins:
             Redis: Redis
             Relations: Relaciones
             Release Notes: Notas de Versiones
+            Request: Solicitud
             Routing: Routing
             Schema: Esquema
             Security: Seguridad