Angenommen, Sie möchten auf die IP-Adresse/den Host des Clients in Ihrer *Pfadoperation-Funktion* zugreifen.

Dazu müssen Sie direkt auf den Request zugreifen.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

Durch die Deklaration eines *Pfadoperation-Funktionsparameters*, dessen Typ der `Request` ist, weiß **FastAPI**, dass es den `Request` diesem Parameter übergeben soll.

/// tip | Tipp

Ensuite, **FastAPI** appellera cette surcharge au lieu de la dépendance originale.

{* ../../docs_src/dependency_testing/tutorial001_an_py310.py hl[26:27,30] *}

/// tip | Astuce

Vous pouvez définir une surcharge de dépendance pour une dépendance utilisée n’importe où dans votre application **FastAPI**.

Vamos imaginar que você deseja obter o endereço de IP/host do cliente dentro da sua *função de operação de rota*.

Para isso você precisa acessar a requisição diretamente.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

Ao declarar o parâmetro com o tipo sendo um `Request` em sua *função de operação de rota*, o **FastAPI** saberá como passar o `Request` neste parâmetro.

/// tip | Dica

Y entonces **FastAPI** llamará a esa dependencia para sobreescribir en lugar de la dependencia original.

{* ../../docs_src/dependency_testing/tutorial001_an_py310.py hl[26:27,30] *}

/// tip | Consejo

Puedes sobreescribir una dependencia utilizada en cualquier lugar de tu aplicación **FastAPI**.

하지만 새로운 항목을 허용하기를 원할 것입니다. 그리고 항목이 이전에 존재하지 않았다면 이를 생성하고 HTTP 상태 코드 201 "Created"를 반환합니다.

이를 위해서는 `JSONResponse`를 가져와서 원하는 `status_code`를 설정하여 콘텐츠를 직접 반환합니다:

{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

/// warning

위의 예제처럼 `Response`를 직접 반환하면 바로 반환됩니다.

모델 등과 함께 직렬화되지 않습니다.

원하는 데이터가 있는지, 값이 유효한 JSON인지 확인합니다(`JSONResponse`를 사용하는 경우).

///

/// note | 기술 세부사항

Imaginons que vous souhaitiez obtenir l'adresse IP/l'hôte du client dans votre fonction de chemin d'accès.

Pour cela, vous devez accéder directement à la requête.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

En déclarant un paramètre de fonction de chemin d'accès de type `Request`, **FastAPI** saura passer la `Request` dans ce paramètre.

/// tip | Astuce

但在某些特定情境下，直接取得 `Request` 物件會很實用。

## 直接使用 `Request` 物件 { #use-the-request-object-directly }

假設你想在你的 路徑操作函式（path operation function） 中取得用戶端的 IP 位址／主機。

為此，你需要直接存取請求。

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

只要在 路徑操作函式 中宣告一個型別為 `Request` 的參數，FastAPI 就會將當前的 `Request` 傳入該參數。

/// tip

注意在這個例子中，除了 request 參數之外，我們也宣告了一個路徑參數。

因此，路徑參數會被擷取、驗證、轉換為指定型別，並在 OpenAPI 中加入標註。

同理，你可以照常宣告其他參數，並另外同時取得 `Request`。

{* ../../docs_src/templates/tutorial001_py310.py hl[4,11,15:18] *}

/// note | Примітка

До FastAPI 0.108.0, Starlette 0.29.0, параметр `name` був першим.

<div class="termy">

```console
$ cd ~/code/prisoner-of-azkaban

$ python main.py

// Fehler beim Importieren von sirius, es ist nicht installiert 😱
Traceback (most recent call last):
    File "main.py", line 1, in <module>
        import sirius
```

</div>

<div class="termy">

```console
$ cd ~/code/prisoner-of-azkaban

$ python main.py

// Erreur lors de l'import de sirius, il n'est pas installé 😱
Traceback (most recent call last):
    File "main.py", line 1, in <module>
        import sirius
```

</div>