Comprendre ce qu’une API attend, ce qu’elle renvoie et comment l’appeler : une référence OpenAPI interactive, intégrable dans une application React.
Conception et développement de la bibliothèque, du moteur TypeScript et de son CLI, puis intégration dans MoodDish.
Fais défiler pour découvrir
ce qui se passe à l’intérieur.
La référence API dans MoodDish
Specanto transforme un document OpenAPI en une interface lisible : les routes, leurs paramètres et leurs réponses restent réunis dans le même espace.
La référence API dans MoodDish
La console permet de renseigner les paramètres et de préparer un appel HTTP. Les exemples de code suivent le formulaire, pour passer de la documentation à son propre projet.
La console et l’exemple Fetch
J’ai conçu Specanto comme un package React, puis je l’ai intégré à la documentation de MoodDish. Le CLI prépare une application Vite et un document OpenAPI à adapter à son backend.
Les visuels montrent des routes publiques documentées de MoodDish et des exemples issus des schémas OpenAPI.
L’intégration MoodDish sur mobile
Une référence API responsive avec recherche, schémas et console HTTP, des exemples cURL, Fetch et Python, une comparaison de spécifications et un CLI pour démarrer une documentation locale. La bibliothèque est publiée sur npm et intégrée à la documentation de MoodDish.
Document OpenAPI 3.0 / 3.1, fourni en JSON, YAML ou par URL
TypeScript : lecture des schémas, construction des requêtes et comparaison des contrats
Composants React : référence API, console HTTP et comparaison de spécifications
Package npm sous licence MIT · CLI pour une app Vite · API de démonstration Bun
Le cœur TypeScript n’importe pas React. Il normalise le sous-ensemble OpenAPI pris en charge et construit les requêtes utilisées par la console et les exemples de code. La bibliothèque s’intègre à une application existante ; le serveur Bun appartient à la démo.
Le composant de comparaison lit deux fichiers JSON ou YAML et confronte leurs opérations, paramètres, schémas et exigences d’authentification. Le moteur classe les changements et signale les ruptures potentielles dans le périmètre qu’il sait comparer.
L’app de documentation MoodDish importe ApiReference depuis @specanto/react et charge son fichier OpenAPI local. Le CLI fournit aussi un starter Vite avec un proxy de développement ; la spécification reste un document à renseigner, sans détection automatique des routes backend.
Clique sur une capture
pour explorer les détails.