Fern

Fern est une plateforme qui génère automatiquement des SDK et de la documentation API à partir de la définition de votre API. Vous fournissez votre spécification OpenAPI, AsyncAPI ou gRPC, et Fern crée des bibliothèques clientes prêtes à l'emploi dans des langages tels que TypeScript, Python, Go, Java, Ruby, C#, PHP et Swift.

La plateforme construit également des sites de documentation qui ont un aspect professionnel et correspondent à votre identité de marque. Ces sites incluent des références API interactives, des exemples de code et un environnement de test où les développeurs peuvent essayer votre API sans quitter la documentation.

Fern est open source et disponible sur GitHub. Il s'intègre à votre flux de travail existant en publiant les SDK directement sur des registres de paquets comme npm et PyPI. L'outil est conçu pour les entreprises qui souhaitent offrir une excellente expérience développeur sans consacrer de ressources d'ingénierie à la maintenance manuelle des SDK.

Commencer avec Fern est simple. Voici comment l'utiliser :

• Installez l'interface en ligne de commande Fern (CLI) via npm en exécutant la commande d'installation dans votre terminal. Vous aurez besoin de Node.js version 18 ou supérieure.

• Initialisez un projet Fern en exécutant la commande init avec votre spécification OpenAPI. Vous pouvez utiliser un fichier local ou fournir une URL vers votre spécification API.

• Configurez les sorties souhaitées dans le fichier des générateurs. Vous pouvez choisir de générer des SDK dans plusieurs langages, créer de la documentation, ou les deux.

• Exécutez la commande generate pour créer vos SDK et votre documentation. Fern traite votre définition d'API et génère les artefacts demandés.

• Personnalisez votre documentation en ajoutant des pages markdown, en ajustant les couleurs et les polices, et en configurant votre domaine personnalisé.

• Configurez la publication automatique afin que Fern puisse pousser vos SDK vers les registres de paquets et mettre à jour votre site de documentation chaque fois que vous effectuez des modifications API.

• Génération automatique de SDK en plus de 8 langages de programmation

• Sites de documentation API de style Stripe

• Publication directe sur les registres de paquets

• Support OpenAPI et AsyncAPI

• Environnement interactif pour API avec tests en direct

• Personnalisation de la marque et support de domaine

• OAuth 2.0 intégré et authentification

• Pagination automatique et logique de nouvelle tentative

• Support WebSocket et SSE

• Contrôle de version avec Git

• Assistant de recherche alimenté par l’IA

• Open source sur GitHub