Paramètres OpenAPI
Les OpenAPI Settings sont l’endroit où vous pouvez configurer votre fichier OpenAPI importé.
Comment accéder aux OpenAPI Settings
Allez dans le Space et cliquez sur les 3 points ⫶
Cliquez maintenant sur Paramètres Open API
Général
L’onglet Général des OpenAPI Settings vous permet de :
- Afficher le lien de téléchargement Open API
- Créer une catégorie Models
- Rédiger une API Introduction
Synchronisation manuelle
L’onglet Synchronisation manuelle vous permet de mettre à jour votre fichier API manuellement.
Vous pouvez soit l’ajouter depuis votre stockage local, soit fournir une URL vers votre fichier et Archbee le mettra à jour.
Synchronisation via API
La Synchronisation via API vous permet d’utiliser notre API publique pour synchroniser le fichier OpenAPI.
C’est un outil puissant puisqu’il vous permet de l’intégrer avec votre CI/CD et d’effectuer des mises à jour automatiques selon votre processus de développement/déploiement.
Exemples de langages
À partir du changement de langage, vous pouvez modifier le langage de programmation dans lequel l’exemple de code est affiché.
Chaque fichier OpenAPI importé comporte, soit sur la droite, soit en dessous, un tiroir de code qui contient l’exemple de code de la requête API.
Par défaut, cet exemple de code est affiché dans 4 langages de programmation :
- cURL
- JS
- Python
- Ruby
Dans le menu Language Change, vous pouvez mettre à jour ces paramètres, et voici comment faire :
Ouvrir l’onglet Exemple de langue
Pour ajouter une nouvelle langue il suffit de la sélectionner dans le menu déroulant, ou pour retirer une langue il suffit de cliquer sur le bouton « X » à côté ;
Fermez le menu et consultez le tiroir de code et les échantillons de code mis à jour
