Compresseur JSON OpenAPI / Swagger
Collez une spécification JSON OpenAPI 3.x ou Swagger 2.0 pour supprimer les descriptions, les exemples et les extensions x- — réduit la taille de la spécification pour les pipelines de génération de SDK et les imports de passerelle API. S'exécute entièrement dans votre navigateur, sans inscription.
Paste an OpenAPI 3.x or Swagger 2.0 JSON specification to remove descriptions, examples, and x- extensions - reduces spec size for SDK generation pipelines and API gateway imports. Runs entirely in your browser.
Compression Options
Pourquoi utiliser notre compresseur OpenAPI ?
- Compression de spécifications OpenAPI instantanée : collez n'importe quelle spécification JSON OpenAPI 3.x ou Swagger 2.0 et compressez-la instantanément dans votre navigateur — supprime les descriptions, les exemples et les extensions x- en quelques millisecondes.
- Compresseur OpenAPI en ligne sécurisé : votre spécification d'API ne quitte jamais votre appareil. Toute la compression s'exécute localement dans le navigateur — sûr pour les spécifications d'API internes ou propriétaires contenant des informations d'endpoint sensibles.
- Options de compression granulaires : choisissez précisément ce qu'il faut supprimer — descriptions, résumés, exemples, extensions x-, indicateurs deprecated ou espaces blancs JSON — avec un aperçu en direct de la sortie compressée.
- 100 % gratuit pour toujours : compressez autant de spécifications OpenAPI que nécessaire, entièrement gratuitement. Sans compte, sans abonnement, sans limite de taille de fichier et sans publicité.
Qu'est-ce que la compression de spécifications OpenAPI ?
La compression de spécifications OpenAPI consiste à supprimer les champs de documentation uniquement d'une spécification JSON OpenAPI afin de réduire sa taille pour les cas d'usage programmatiques comme la génération de SDK, les imports de passerelle API et les pipelines CI/CD. Les grandes spécifications OpenAPI peuvent atteindre plusieurs mégaoctets lorsqu'elles incluent des descriptions verbeuses, des exemples en ligne et des champs d'extension fournisseur — dont aucun n'est nécessaire à la génération de code. Notre compresseur OpenAPI gratuit supprime ces champs dans votre navigateur et affiche exactement ce qui a été retiré.
Comment fonctionne notre compresseur OpenAPI
- Collez votre spécification : copiez votre spécification JSON OpenAPI 3.x ou Swagger 2.0 et collez-la dans le panneau de saisie. Utilisez le bouton d'exemple pour charger une spécification type.
- Choisissez les options de compression : sélectionnez les champs à supprimer — descriptions, résumés, exemples, extensions x-, indicateurs deprecated ou espaces blancs JSON. La sortie se met à jour instantanément.
- Copiez ou téléchargez : copiez la spécification compressée dans votre presse-papiers ou téléchargez-la en fichier .json, puis utilisez-la dans votre générateur de SDK ou votre passerelle API.
Ce qui est supprimé lors de la compression
- Descriptions : tous les champs « description » des chemins, opérations, paramètres, corps de requête, réponses et schémas — documentation uniquement, non utilisés par les générateurs.
- Exemples : les champs « example » et « examples » des schémas et paramètres — utilisés uniquement pour le rendu de la documentation.
- Extensions x- : tous les champs d'extension fournisseur commençant par x- — métadonnées internes ajoutées par les outils de gestion d'API.
- Espaces blancs JSON : toute l'indentation, les sauts de ligne et les espaces entre les jetons — produit une sortie JSON minifiée sur une seule ligne.
Ce qui est préservé
Tous les champs structurels nécessaires à la génération de SDK et aux imports de passerelle API sont entièrement préservés : chemins, méthodes HTTP, identifiants d'opération, paramètres (name, in, required, schema), corps de requête, codes de statut de réponse, schémas de réponse, définitions de composants, schémas de sécurité et URL de serveur. La spécification compressée est fonctionnellement identique à l'originale pour tous les cas d'usage programmatiques.
Foire aux questions
Un compresseur OpenAPI supprime les champs verbeux comme les descriptions, les exemples et les extensions x- des spécifications JSON OpenAPI afin de réduire leur taille pour la génération de SDK, les imports de passerelle API et les pipelines CI/CD. Notre compresseur OpenAPI en ligne gratuit s'exécute entièrement dans votre navigateur — sans inscription ni envoi vers un serveur.
Non. Les générateurs de SDK (OpenAPI Generator, Swagger Codegen, Kiota) n'utilisent que les champs structurels — chemins, opérations, paramètres, corps de requête, schémas de réponse et définitions de composants. Les descriptions et les exemples sont des champs de documentation uniquement qui n'affectent pas le code généré.
Oui, la confidentialité totale est garantie. Toute la compression s'exécute côté client dans votre navigateur. Votre spécification OpenAPI — qui peut contenir des chemins d'endpoints internes, des schémas d'authentification et des modèles de données propriétaires — ne quitte jamais votre appareil et n'est jamais envoyée à un serveur.
Oui. Le compresseur OpenAPI est 100 % gratuit, sans inscription, sans abonnement, sans limite de taille de spécification et sans publicité. Vous pouvez compresser autant de spécifications que nécessaire.
Dans OpenAPI 3.x, « summary » est une courte description d'une ligne d'une opération (affichée dans la navigation de la documentation d'API), tandis que « description » est une explication plus longue au format markdown. Les deux sont des champs de documentation uniquement — les supprimer n'a aucun effet sur la génération de SDK ni sur le comportement de la passerelle API.
Les champs d'extension x- sont des métadonnées spécifiques au fournisseur ajoutées par les outils de gestion d'API, les passerelles ou l'outillage interne (par exemple x-rate-limit, x-internal-id, x-amazon-apigateway-integration). Leur suppression est sans risque pour la génération de SDK, mais ils peuvent être requis pour certains imports de passerelle API. Consultez la documentation de votre passerelle avant de les supprimer.
Oui. Le compresseur fonctionne avec les spécifications JSON Swagger 2.0 (swagger: "2.0") et OpenAPI 3.0/3.1 (openapi: "3.x.x"). Les mêmes champs (descriptions, exemples, extensions x-) existent dans les deux formats et sont supprimés par la même logique.
La version actuelle du compresseur ne prend en charge que l'entrée JSON. Pour compresser une spécification YAML, convertissez-la d'abord en JSON avec un convertisseur YAML vers JSON, puis compressez-la ici.