Linter OpenAPI en ligne — Règles de style pour specs

Analysez le style de vos specs OpenAPI 3.x (sous-ensemble Spectral) — opérations paths uniquement, 100 % navigateur.

Chargement…
Documentation Linter OpenAPI
Appliquez un sous-ensemble de règles style Spectral aux opérations paths.

Notes développeur

• Sous-ensemble style Spectral — pas Spectral OAS complet. • Opérations sous paths uniquement (pas webhooks/callbacks en v1). • Règles : not-openapi, operation-operationId, operation-tags, info-contact, info-description, paths-kebab-case, operation-success-response, operation-description. • Lint live debounced ; entrée Monaco JSON/YAML auto-détectée. • Statuts : passed / passed with warnings / failed. • Limite 512 Kio. • Le panneau Résultats affiche compteurs, chemins et stats spec.

Cas d’usage

• Imposer operationId, tags et réponses 2xx sur les opérations paths. • Repérer info.contact / description manquants avant publication. • Préférer les segments de chemin en kebab-case (ou vN).

Exemples

Avertissements sans operationId

Avant

{ "openapi": "3.1.0", "info": { "title": "Pets", "version": "1.0.0" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": ["pets"], "summary": "List pets", "responses": { "200": { "description": "OK" } } } } } }

Après

operation-operationId (avertissement) si operationId manquant

réponses default seules = échec

Avant

{"openapi":"3.1.0",…,"responses":{"default":{"description":"e"}}}

Après

operation-success-response (erreur) → failed

FAQ Linter OpenAPI

Questions fréquentes

Est-ce Spectral complet ?

Non. La v1 livre un sous-ensemble fixe listé dans les notes développeur — pas d’exécution de ruleset personnalisé.

Quelles opérations sont analysées ?

Uniquement les opérations paths (get/put/post/delete/options/head/patch/trace). webhooks et callbacks hors scope v1.

Que signifient passed / warnings / failed ?

failed = au moins une erreur ; passed with warnings = avertissements seulement ; passed = aucun problème. Jamais de vert « valide » s’il y a des warnings.

Le lint fait-il la validation schéma ?

Non. Le lint exige openapi 3.x + info, puis les règles de style. Utilisez Valider OpenAPI pour la conformité schéma.

API & schémas

Outils OpenAPI pour formater, valider et analyser vos specs.

Découvrez les autres catégories d'outils

Minifier

Réduisez code et assets pour la production — minifiez JS, CSS, HTML, JSON, XML et SVG avant gzip ou déploiement CDN.

Beautifier

Rendez le code lisible avec une indentation cohérente — beautifiez JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML et plus encore dans votre navigateur.

Déminifier

Développez du code minifié ou compressé — déminifiez JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML et d'autres formats pour déboguer ou relire.

Conversion

Transformez des données entre JSON, YAML, XML et CSV localement — sans envoi serveur.

Préprocesseurs CSS

Compilez SCSS ou LESS en CSS standard dans le navigateur — complétez avec beautify ou minify pour un workflow feuille de style complet.

Outils JSON

Validez, formatez, comparez et explorez des payloads JSON — complémentaires aux minificateurs et convertisseurs.

Outils SVG

Prévisualisez, optimisez avec SVGO, exportez en Data URI, redimensionnez, formatez, convertissez en JSX et validez vos SVG — tout dans le navigateur.

DevOps & Infra

Format/validate/minify HCL, format & lint Dockerfile, validation Compose et .env.

CI/CD

GitHub Actions et GitLab CI — formater le YAML et vérifier la structure des workflows/jobs dans le navigateur.

Logs & observabilité

JSON/NDJSON ligne à ligne et access logs Nginx/Apache — format, filtre, validation et CSV/TSV.

Kubernetes

Manifestes multi-docs, validation structurelle, starters Ingress/Deployment et formatage values Helm.

Réseau / IP

CIDR, sous-réseaux et helpers IPv4/IPv6 — dans le navigateur.

Sécurité & tokens

JWKS, certificats X.509 et scan de secrets — locaux navigateur.

Encodage

Encodez ou décodez Base64, composants URL et entités HTML — uniquement côté client.

Utilitaires développeur

Timestamps, UUID, ULID, Nanoid, cron, mots de passe, regex, slugify, bases, casse, diff texte et chmod — tout côté client.

Texte & Markdown

Comptez, générez un sommaire Markdown et nettoyez des listes de lignes — dans le navigateur.

IA & LLM

Comptage de tokens, estimation des coûts et fenêtre de contexte — 100 % local.

Sérialisation

Sérialisez et désérialisez des structures PHP à côté de vos flux JSON.