---
title: Importation d’OpenAPI / Swagger
slug: docs/fr/importation-dopenapi-swagger
description: Apprenez comment tirer parti de la puissance de l’importation OpenAPI dans Archbee pour une documentation produit axée sur les développeurs. Découvrez les avantages, les versions prises en charge, les méthodes d’authentification, la pré‑population des par
createdAt: 2021-10-29T07:42:12.000Z
---

## Pourquoi utiliser l’import OpenAPI ?

Si votre produit est conçu pour les développeurs ou si votre produit possède une API, vous avez besoin d’une excellente documentation produit — sinon, vous ne pouvez pas atteindre les développeurs efficacement.

Une fois que vous importez votre fichier OpenAPI, Archbee le lira et le convertira en une interface utilisateur élégante et le rendra prêt à être :

- **Partagé publiquement **(sur un domaine personnalisé) 
- **Interne** avec vos collègues et équipes

Une fois importé, vous pouvez synchroniser, mettre à jour et tester votre OpenAPI. Consultez plus de détails dans les sections ci-dessous.

## Règles et paramètres par défaut

:::hint{type="info"}
Les fichiers OpenAPI importés ne peuvent pas être modifiés manuellement dans Archbee.

Pour mettre à jour et maintenir votre OpenAPI, consultez nos [options de synchronisation](docId\:OeM3qMPUaNWF6OO69D5fV)
:::

### Versions OpenAPI prises en charge :

Archbee prend actuellement en charge les versions OpenAPI suivantes pour l’import :

1. Version 2.0 et 2.0.XX
2. Version 3.0 et 3.0.XX
3. Version 3.1 et 3.1.XX

### Méthodes d’authentification prises en charge

Archbee prend actuellement en charge les méthodes d’authentification suivantes :

1. [Basic Authentication](https://swagger.io/docs/specification/authentication/basic-authentication/)
2. [API Keys](https://swagger.io/docs/specification/authentication/api-keys/)
3. [Bearer Authentication](https://swagger.io/docs/specification/authentication/bearer-authentication/)

Si vous importez des fichiers OpenAPI avec d’autres méthodes d’authentification, ils seront importés correctement et la méthode d’authentification sera ignorée.

Cela signifie que vous bénéficierez de toute l’expérience OpenAPI d’Archbee, **sauf **la fonctionnalité Try It!, si votre endpoint nécessite une méthode d’authentification qui ne figure pas dans la liste ci-dessus.

### Autres

1. Si vous définissez un paramètre « **par défaut** » dans votre OpenAPI et que vous lui attribuez une valeur, l’exemple de code et la boîte de paramètres seront automatiquement préremplis avec cette valeur.

   Cela permet à vos utilisateurs ou clients de tester votre API avec [Essayez !](docId\:HSbwn6fqkwuN7U8RNhHzr) sans avoir à mettre à jour tous les paramètres requis.

2. Si vous définissez un paramètre « **exemple** » dans votre OpenAPI, la valeur d’exemple sera affichée sur le côté gauche juste en dessous du paramètre API.

   Cela permet à vos utilisateurs d’identifier facilement quel type d’entrée est nécessaire pour ce paramètre spécifique.

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

## Comment cela fonctionne-t-il ?

::::WorkflowBlock
:::WorkflowBlockItem
Importez votre fichier OpenAPI en utilisant l’option **Importer du contenu** :

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

Ou utilisez l’option **Importation** depuis chaque espace :

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

Ou synchronisez vos fichiers OpenAPI directement depuis votre dépôt [GitHub](docId\:v6Et-Ky42bRiuYDhoz8Cy).

Avec l’intégration [Intégration GitHub](docId\:v6Et-Ky42bRiuYDhoz8Cy) d’Archbee, vous pouvez ajouter et synchroniser vos fichiers OpenAPI directement depuis votre dépôt.
:::

:::WorkflowBlockItem
Prévisualisez et [test](docId\:HSbwn6fqkwuN7U8RNhHzr) votre fichier OpenAPI importé

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

Prévisualisez et testez votre fichier OpenAPI nouvellement importé avec la fonctionnalité [API ESSAYEZ-LE !](docId\:HSbwn6fqkwuN7U8RNhHzr) d’Archbee.
:::

:::WorkflowBlockItem
**Publiez** ou **partagez-le** avec vos collègues ou vos clients !

Publiez-le dans Preview ou sur un Custom Domain et rendez-le accessible à vos collègues, équipes ou utilisateurs.

Si vous souhaitez protéger le contenu et ne le partager qu’avec quelques personnes sélectionnées, consultez nos options de [Contrôles d'accès public](docId\:rcEK0l-DvXdZG7NbnO9Pq) pour les portails publiés.
:::

:::WorkflowBlockItem
Maintenez-le, synchronisez-le et configurez-le :

1. [Synchronisez‑le manuellement](docId\:OeM3qMPUaNWF6OO69D5fV)
2. [Synchroniser automatiquement via l’API](docId\:OeM3qMPUaNWF6OO69D5fV)
3. [Modifier la langue du code d'exemple](docId\:OeM3qMPUaNWF6OO69D5fV)
:::
::::

## Voici une vidéo montrant comment cela fonctionne

::embed[]{url="https://youtu.be/LQ3nEGCcdKg"}