---
title: API Essayez‑le!
slug: api-essayezle
description: Découvrez comment utiliser la fonction « ESSAYEZ‑LE! » pour tester facilement des API dans votre navigateur Web. Découvrez les étapes nécessaires, y compris l’importation des fichiers API, la configuration des valeurs par défaut et la définition des param
docTags: 
createdAt: 2023-04-26T07:38:48.000Z
---

:::hint{type="info"}
La fonctionnalité **Essayez-le !** vous permet de tester votre API directement dans votre navigateur. Elle fonctionne à la fois sur un portail de documentation publié ou directement dans l’éditeur.
:::

## Comment configurer

La fonctionnalité **Essayez-le !** utilise l’[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 ce qui suit :

- un URL de chemin absolu vers votre API (et non seulement un chemin)
  - ajoutez dans votre fichier .yml un URL comme suit
- serveurs :
  - 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\:w6njSbnrW4P8tizZtRTt6) ou [synchronisation GitHub](docId\:fS1vd6c9fHGu7YrsCT4Qr))
:::

:::WorkflowBlockItem
\[Optionnel] Définissez les valeurs [« par défaut »](docId\:w6njSbnrW4P8tizZtRTt6) dans votre fichier OpenAPI. De cette façon, 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 avoir mis à jour les paramètres, l’exemple de code à droite (ou en dessous, selon la configuration de votre vue) sera également mis à 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
Appuyez 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)
:::
::::