Visualiseur de spécifications OpenAPI

Le Visualiseur de Spécifications OpenAPI est un outil en ligne gratuit qui analyse et explore les spécifications OpenAPI/Swagger avec navigation des endpoints, inspection des schémas et génération de cURL. Il fonctionne entièrement dans votre navigateur, sans installation ni inscription.

OpenAPI 3.x et Swagger 2.0, en JSON comme en YAML. Détection automatique du format.

Exportez en JSON ou YAML quel que soit le format d'entrée. Copiez la spécification complète dans le presse-papiers.

Cliquez sur n'importe quel endpoint et utilisez Copier en tant que cURL. Génère la commande avec l'URL du serveur, la méthode, les en-têtes et les emplacements pour le corps.

Oui, le Visualiseur de Spécifications OpenAPI est 100 % gratuit, sans inscription, sans frais cachés et sans limite d'utilisation. Tout le traitement se fait localement dans votre navigateur, garantissant une confidentialité totale.

Tout à fait. Le Visualiseur de Spécifications OpenAPI traite tout côté client, dans votre navigateur. Aucune donnée n'est envoyée ni stockée sur un serveur. Votre contenu reste privé sur votre appareil à tout moment.

Oui, le Visualiseur de Spécifications OpenAPI est entièrement adaptatif et fonctionne sur smartphones et tablettes. Vous pouvez l'utiliser sur tout appareil doté d'un navigateur web moderne, sans aucune application à télécharger.

Aucun compte ni inscription n'est nécessaire. Ouvrez simplement le Visualiseur de Spécifications OpenAPI dans votre navigateur et commencez à l'utiliser immédiatement. Il n'y a ni barrière d'inscription ni restriction d'usage.

Le Visualiseur de Spécifications OpenAPI prend en charge un large éventail de formats et de langages populaires. Consultez l'interface de l'outil pour la liste complète des options prises en charge.

Saisissez simplement votre entrée dans le champ prévu, ajustez les options à votre convenance et l'outil la traitera instantanément. Vous pouvez ensuite copier le résultat dans le presse-papiers ou le télécharger.

Swagger était le nom d'origine de la spécification, et la version 2.0 est encore largement appelée « Swagger ». En 2016, le format a été confié à l'OpenAPI Initiative et renommé OpenAPI, si bien que la version 3.x est officiellement appelée OpenAPI. Aujourd'hui, « Swagger » désigne généralement l'outillage — Swagger UI, Swagger Editor, Codegen — tandis qu'« OpenAPI » désigne le document de spécification lui-même. Les deux appartiennent à la même famille : ils décrivent tous deux les points de terminaison, paramètres, corps de requête, réponses et modèles de données d'une API REST dans un seul fichier JSON ou YAML. Le principal changement structurel en 3.x est que les paramètres de corps et les modèles de réponse ont été déplacés dans une section réutilisable « components/schemas », et « definitions » est devenu « schemas ». Ce visualiseur lit à la fois Swagger 2.0 et OpenAPI 3.x, détecte automatiquement la version de votre document et l'affiche de la même manière : collez l'un ou l'autre format pour l'explorer.

Oui. Comme le visualiseur transforme votre spécification en un objet structuré en mémoire, il peut vous rendre le même document dans l'un ou l'autre format de sérialisation, quel que soit celui que vous avez collé. Déposez une spécification YAML et utilisez Export JSON pour télécharger une version JSON correctement formatée, ou collez du JSON et utilisez Export YAML pour obtenir l'équivalent YAML indenté — la description de l'API, les points de terminaison et les schémas restent identiques, seule la syntaxe change. C'est pratique lorsqu'un outil de build, un serveur de mock ou un générateur de client attend un format alors que votre équipe a rédigé la spécification dans l'autre. Vous pouvez aussi copier l'intégralité du document converti directement dans votre presse-papiers. Tout cela s'exécute localement dans votre navigateur, de sorte qu'une spécification interne ou non publiée ne quitte jamais votre machine. Collez votre fichier et choisissez le format d'export dont vous avez besoin.

Le format est détecté automatiquement à partir du premier caractère non blanc. Si votre texte collé commence par une accolade ouvrante, il est traité comme du JSON et analysé en conséquence ; tout le reste est analysé comme du YAML, puisqu'une spécification JSON valide commence toujours par un objet. Après l'analyse, le visualiseur vérifie la présence d'un champ « openapi » ou « swagger » pour confirmer qu'il s'agit bien d'une spécification authentique et non de données arbitraires. Si l'analyse échoue — une tabulation isolée, une guillemet manquante, une indentation incorrecte — l'outil affiche le message d'erreur exact plutôt qu'un écran vide, afin que vous puissiez trouver et corriger le problème rapidement. Cela signifie que vous n'avez jamais besoin d'indiquer le format utilisé ni de retirer des commentaires au préalable. Collez simplement le contenu brut de votre fichier de spécification et le visualiseur se charge du reste, puis affiche l'API.

Les spécifications OpenAPI évitent les répétitions en définissant les modèles une seule fois sous « components/schemas » et en y renvoyant ailleurs via des références « $ref » — une réponse peut référencer un schéma Pet qui référence lui-même une Category et un tableau de Tags. Dans l'onglet Schémas, le visualiseur affiche chaque modèle sous forme d'arborescence dépliable et résout ces références « $ref » vers le modèle qu'elles ciblent, ce qui permet de naviguer dans les objets et tableaux imbriqués au lieu de faire défiler du texte brut à la recherche des définitions. Chaque propriété indique son type, son format, si elle est obligatoire et ses éventuelles options d'énumération, ce qui rend la structure réelle de chaque modèle claire en un coup d'œil. Cela vous évite de devoir croiser manuellement différentes parties du fichier pour comprendre comment les données s'articulent. Ouvrez l'onglet Schémas après avoir analysé votre spécification pour parcourir visuellement les relations entre modèles.

Le code couleur est une aide à la lisibilité qui permet de parcourir une API volumineuse sans avoir à lire chaque étiquette. Chaque opération porte un badge de méthode — GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS — coloré selon le verbe, ce qui permet de distinguer les lectures sûres des écritures et suppressions lorsque vous parcourez une longue liste de points de terminaison regroupés par tag. Dans un point de terminaison développé, les codes de statut des réponses sont colorés selon leur classe : succès 2xx, redirections 3xx, erreurs client 4xx et erreurs serveur 5xx se distinguent chacun d'un coup d'œil, ce qui permet de voir immédiatement quelles réponses une opération peut renvoyer. Les opérations dépréciées sont signalées séparément afin que vous ne construisiez pas votre code sur un point de terminaison en voie de disparition. Ensemble, ces indices transforment une spécification dense en quelque chose que vous pouvez trier rapidement. Collez une spécification, ou chargez l'exemple Petstore intégré, pour voir ce code couleur en action.