---
title: Essayez l’API!
slug: docs/fr/essayez-lapi
description: Apprenez comment utiliser la fonction « ESSAYEZ-LE! » pour tester des API facilement dans votre navigateur Web. Découvrez les étapes nécessaires, y compris l’importation de fichiers API, la configuration des valeurs par défaut et la définition des paramèt
createdAt: 2023-04-26T07:38:48.000Z
---

:::hint{type="info"}
La fonctionnalité **ESSAYEZ !** vous permet de tester votre API directement dans votre navigateur. Elle fonctionne aussi bien sur un portail de documentation publié que directement dans l’éditeur.
:::

## Comment configurer

La fonctionnalité **Essayez‑le !** utilise le [fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch), donc pour qu’elle fonctionne, vos imports d’API doivent inclure les éléments suivants :

- un URL de chemin absolu vers votre API (pas seulement un chemin)
  - ajoutez dans votre fichier .yml un URL comme suit
- servers :
  - exemple d’URL : https\://petstore3.swagger.io/api/v3 (votre URL réelle)
- les méthodes d’autorisation seront lues à partir de votre fichier API et incluses dans chaque page d’API
- CORS désactivé ou activé pour le domaine de documentation, afin que les utilisateurs puissent réellement tester votre API

## Comment cela fonctionne

::::WorkflowBlock
:::WorkflowBlockItem
Importez vos fichiers API ([importation directe](docId\:k-ZpuvcajRrTTpxxGjwuP) ou [synchronisation github](docId\:v6Et-Ky42bRiuYDhoz8Cy))
:::

:::WorkflowBlockItem
\[Optionnel] Définissez les valeurs [« par défaut »](docId\:k-ZpuvcajRrTTpxxGjwuP) dans votre fichier OpenAPI. De cette manière, lorsque vous importez votre API, toutes les valeurs « par défaut » seront ajoutées à l’exemple de code et vous pourrez tester votre API immédiatement sans devoir ajouter manuellement des valeurs aux paramètres.
:::

:::WorkflowBlockItem
Configurez la méthode API avec les paramètres de test

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/wnjtlYGiV-WHIota1T9da_tryit-light.png)
:::

:::WorkflowBlockItem
Après que vous mettez à jour les paramètres, l’exemple de code à droite (ou en dessous, selon la configuration de votre vue) se mettra également à jour avec les paramètres de test que vous avez ajoutés, vous fournissant l’extrait de code de la requête dans plusieurs langages.

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/WaqQRkD0Pzl7vY4HXPjWS_matching-items-light.png)
:::

:::WorkflowBlockItem
Cliquez sur le bouton **Essayez‑le !** et vérifiez la zone de réponse, sous l’exemple de code

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/h3z_pRa5GGHM4S2OFI7nf_response-light.png)
:::
::::