{* ../../docs_src/query_params/tutorial005.py hl[6:7] *}

Ici le paramètre `needy` est un paramètre requis (ou obligatoire) de type `str`.

Si vous ouvrez une URL comme :

```
http://127.0.0.1:8000/items/foo-item
```

...sans ajouter le paramètre requis `needy`, vous aurez une erreur :

```JSON
{
    "detail": [
        {
            "loc": [
                "query",
                "needy"

* Passer la donnée reçue dans le paramètre `item`.
    * Ce paramètre ayant été déclaré dans la fonction comme étant de type `Item`, vous aurez aussi tout le support offert par l'éditeur (auto-complétion, etc.) pour tous les attributs de ce paramètre et les types de ces attributs.

,EAAQ8Q,MAAMkJ,YAC7BC,EAAmBxZ,UAAET,GAASU,IAAI,gBACxCD,UAAET,GACCmG,KAAK,eAAgB4T,GACrBrZ,IAAI,eAAmBG,WAAWoZ,GAAoBP,EAAKrD,gBAF9D,SAMF,IAAMwD,EAAgBha,SAAS6T,KAAK5C,MAAMqI,aACpCW,EAAoBrZ,UAAEZ,SAAS6T,MAAMhT,IAAI,iBAC/CD,UAAEZ,SAAS6T,MACRvN,KAAK,gBAAiB0T,GACtBnZ,IAAI,gBAAoBG,WAAWiZ,GAAqBnW,KAAK0S,gBAFhE,MAKF5V,UAAEZ,SAAS6T,MAAM1F,SAASoH,KAG5BoD,kBAAA,WAEE,IAAMmB,EAAe,GAAGvR,MAAMnG,KAAKpC,SAASwI,iBAAiBwN,KAC7DpV,UAAEkZ,GAAc1T,MAAK,SAACwF,EAAOzL,GAC3B,IAAMka,EAAUzZ,UAAET,GAASmG,KAAK,iBAChC1F,UAAET,GA...

```Python hl_lines="6"
{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
```

Si vous ouvrez la documentation automatique de l'API, votre extension apparaîtra au bas du *chemin* spécifique.

<img src="/img/tutorial/path-operation-advanced-configuration/image01.png">

Si vous exécutez cet exemple et allez sur <a href="http://127.0.0.1:8000/items/3" class="external-link" target="_blank">http://127.0.0.1:8000/items/3</a>, vous aurez comme réponse :

```JSON
{"item_id":3}
```

/// check | "vérifier"

Comme vous l'avez remarqué, la valeur reçue par la fonction (et renvoyée ensuite) est `3`,

* `--reload` : fait redémarrer le serveur après des changements de code. À n'utiliser que pour le développement.

</details>

### Vérifiez

Ouvrez votre navigateur à l'adresse <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.

/// tip

Ce n'est probablement pas aussi important ou nécessaire si vous utilisez `Annotated`.

///

Voici une **petite astuce** qui peut être pratique, mais vous n'en aurez pas souvent besoin.

Si vous voulez :

* déclarer le paramètre de requête `q` sans `Query` ni valeur par défaut
* déclarer le paramètre de chemin `item_id` en utilisant `Path`
* les avoir dans un ordre différent

```hl_lines="4"
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```

Cette ligne montre l'URL par laquelle l'app est actuellement accessible, sur votre machine locale.

### Allez voir le résultat

Ouvrez votre navigateur à l'adresse <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.

Vous obtiendrez cette réponse JSON :

```JSON
{"message": "Hello World"}
```

# Réponses supplémentaires dans OpenAPI

/// warning | "Attention"

Ceci concerne un sujet plutôt avancé.

Si vous débutez avec **FastAPI**, vous n'en aurez peut-être pas besoin.

///

Vous pouvez déclarer des réponses supplémentaires, avec des codes HTTP, des types de médias, des descriptions, etc.

Ces réponses supplémentaires seront incluses dans le schéma OpenAPI, elles apparaîtront donc également dans la documentation de l'API.

{*../../docs_src/python_types/tutorial010.py hl[1:3] *}


Vous pouvez ensuite déclarer une variable de type `Person` :

{*../../docs_src/python_types/tutorial010.py hl[6] *}

Et vous aurez accès, encore une fois, au support complet offert par l'éditeur :

<img src="/img/python-types/image06.png">

## Les modèles Pydantic