Skip to content
jsonforge.app

OpenAPI & Swagger Viewer

Visionneuse interactive de spécifications OpenAPI 3.x et Swagger 2.0, avec générateurs de code cURL et Fetch.

OpenAPI / Swagger Spec (JSON or YAML)

Loading editor…

OpenAPI Interactive ViewerOpenAPI 3 3.0.3

Petstore API

v1.0.0

A sample Petstore API spec for demonstrating OpenAPI / Swagger rendering

Header Auth / Security:bearerAuth (bearer) → AuthorizationapiKeyAuth → X-API-KEY
Servers:https://petstore.swagger.io/v2
GET/petsList all pets
apiKeyAuth
POST/petsCreate a pet
bearerAuth
GET/pets/{petId}Info for a specific pet

Qu'est-ce que OpenAPI & Swagger Viewer ?

La visionneuse de spécifications OpenAPI & Swagger vous laisse coller ou téléverser n'importe quelle spécification OpenAPI 3.0, 3.1 ou Swagger 2.0 au format JSON ou YAML et la transforme instantanément en interface de documentation d'API interactive et visuelle. Les points de terminaison sont automatiquement regroupés par tags, avec badges de méthode HTTP (GET, POST, PUT, DELETE, PATCH), tableaux de paramètres, définitions de corps de requête et schémas de réponse par code de statut. Elle affiche aussi les exigences d'authentification par en-tête (Bearer JWT, clés d'API, Basic Auth) et fournit une génération d'extraits de code cURL et JavaScript Fetch en un clic pour tester les points de terminaison.

Comment utiliser OpenAPI & Swagger Viewer

  1. Collez votre spécification OpenAPI 3.x ou Swagger 2.0 (JSON ou YAML) dans l'éditeur du panneau de gauche.
  2. La visionneuse interactive à droite analyse votre spécification instantanément et rend tous les points de terminaison de l'API.
  3. Utilisez les filtres de méthode (GET, POST, PUT, etc.) ou la barre de recherche pour filtrer les points de terminaison par chemin, résumé ou tag.
  4. Cliquez sur l'accordéon d'un point de terminaison pour voir les paramètres requis, les corps de requête et les schémas de réponse.
  5. Cliquez sur « cURL » ou « Fetch » pour copier des extraits de code prêts à exécuter pour le terminal ou le navigateur.

Exemples

Inspecter une spécification OpenAPI 3.0

Entrée

openapi: 3.0.3 info: title: My API version: 1.0.0 paths: /users: get: summary: List Users

Sortie

Documentation interactive montrant le point de terminaison GET /users avec codes de statut et schémas de paramètres

Générer un cURL pour un point de terminaison POST

Entrée

openapi: 3.0.0 info: title: Orders API version: 1.0.0 paths: /orders: post: summary: Create Order

Sortie

Copie en un clic d'une commande cURL avec en-têtes de charge utile JSON et jeton d'autorisation Bearer

Erreurs courantes

  • Coller du YAML ou du JSON invalide avec des erreurs de syntaxe — assurez-vous que votre document est valide avant la visualisation.
  • Oublier de définir securitySchemes dans components — sans définitions de sécurité, des jetons bearer par défaut sont générés pour l'autorisation.
  • S'attendre à ce que de vraies requêtes réseau s'exécutent dans la visionneuse — cet outil est conçu pour le rendu de spécifications et la génération d'extraits de code.

Pourquoi utiliser cet outil

  • S'exécute à 100 % côté client — vos contrats d'API, points de terminaison internes et jetons restent privés.
  • Génération instantanée de code cURL et Fetch pour des tests rapides.
  • Prend en charge OpenAPI 3.x comme Swagger 2.0, en JSON et en YAML.

Questions fréquentes

Outils associés

JSON Tree Viewer

Explorez le JSON en arbre dépliable et recherchable, plutôt qu'en bloc de texte plat.

/json-tree-viewer

JSON Preview

Prévisualisez du JSON en texte mis en forme, tableau, diagramme de relations ou arbre — changez de vue instantanément.

/json-preview

JSON to YAML

Convertissez du JSON en YAML et inversement, avec inférence de types et mise en forme propre.

/json-to-yaml

JSON Validator

Validez du JSON contre des schémas avec des rapports d'erreur détaillés. Générez des schémas depuis du JSON.

/json-validator