Sync fastapi docs from b5ca1324 on 2025-12-07

docs/en/docs/advanced/using-request-directly.md

@@ -0,0 +1,56 @@
+# Using the Request Directly { #using-the-request-directly }
+
+Up to now, you have been declaring the parts of the request that you need with their types.
+
+Taking data from:
+
+* The path as parameters.
+* Headers.
+* Cookies.
+* etc.
+
+And by doing so, **FastAPI** is validating that data, converting it and generating documentation for your API automatically.
+
+But there are situations where you might need to access the `Request` object directly.
+
+## Details about the `Request` object { #details-about-the-request-object }
+
+As **FastAPI** is actually **Starlette** underneath, with a layer of several tools on top, you can use Starlette's <a href="https://www.starlette.dev/requests/" class="external-link" target="_blank">`Request`</a> object directly when you need to.
+
+It would also mean that if you get data from the `Request` object directly (for example, read the body) it won't be validated, converted or documented (with OpenAPI, for the automatic API user interface) by FastAPI.
+
+Although any other parameter declared normally (for example, the body with a Pydantic model) would still be validated, converted, annotated, etc.
+
+But there are specific cases where it's useful to get the `Request` object.
+
+## Use the `Request` object directly { #use-the-request-object-directly }
+
+Let's imagine you want to get the client's IP address/host inside of your *path operation function*.
+
+For that you need to access the request directly.
+
+{* ../../docs_src/using_request_directly/tutorial001.py hl[1,7:8] *}
+
+By declaring a *path operation function* parameter with the type being the `Request` **FastAPI** will know to pass the `Request` in that parameter.
+
+/// tip
+
+Note that in this case, we are declaring a path parameter beside the request parameter.
+
+So, the path parameter will be extracted, validated, converted to the specified type and annotated with OpenAPI.
+
+The same way, you can declare any other parameter as normally, and additionally, get the `Request` too.
+
+///
+
+## `Request` documentation { #request-documentation }
+
+You can read more details about the <a href="https://www.starlette.dev/requests/" class="external-link" target="_blank">`Request` object in the official Starlette documentation site</a>.
+
+/// note | Technical Details
+
+You could also use `from starlette.requests import Request`.
+
+**FastAPI** provides it directly just as a convenience for you, the developer. But it comes directly from Starlette.
+
+///