OpenAPI Linter Online – Stilregeln für Spezifikationen

Lint OpenAPI 3.x-Stilregeln (Spectral-Stil-Teilmenge) – nur Pfadoperationen, 100 % im Browser.

OpenAPI Dokument

0Zeichen0 B1Linien

Lint-Ergebnisse

OpenAPI-Dokument einfügen — Befunde und Zähler erscheinen hier, sobald das Lint abgeschlossen ist.

Linting läuft in Ihrem Browser – es wird nichts hochgeladen.

Teilen Sie dieses Tool:

Laden…

Lint OpenAPI Dokumentation

Wenden Sie eine Teilmenge im Spectral-Stil auf Pfadoperationen an.

Hinweise des Entwicklers

• Benutzerdefinierte Teilmenge im Spectral-Stil – kein vollständiges Spectral OAS. • Nur Vorgänge unter Pfaden (keine Webhooks/Callbacks in Version 1). • Regeln: not-openapi, operation-operationId, operation-tags, info-contact, info-description, paths-kebab-case, operation-success-response, operation-description. • Live-Debounced-Lint; Monaco-Eingabe mit JSON/YAML-Erkennung. • Status: bestanden / bestanden mit Warnungen / fehlgeschlagen. • Maximale Eingabe 512 KiB. • Ergebnisbereich zeigt Regelzähler, Issue-Pfade und Spec-Statistiken.

Anwendungsfälle

• Erzwingen Sie operationId, Tags und 2xx-Antworten bei Pfadoperationen. • Erkennen Sie fehlende Informationen, Kontaktinformationen und Beschreibungen vor der Veröffentlichung. • Bevorzugen Sie Dönerhüllen-Pfadsegmente (oder vN).

Beispiele

Warnungen wegen fehlender Operations-ID

Vor

{
  "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"
          }
        }
      }
    }
  }
}

Nach

operation-operationId (Warnung), wenn operationId fehlt

Nur-Standard-Antworten schlagen fehl

Vor

{"openapi":"3.1.0","info":{"title":"t","version":"1","description":"d","contact":{"email":"[email protected]"}},"paths":{"/x":{"get":{"operationId":"x","tags":["t"],"summary":"s","responses":{"default":{"description":"e"}}}}}}

Nach

operation-success-response (Fehler) → fehlgeschlagen

Lint OpenAPI FAQ

Häufige Fragen

Ist das Full Spectral?

Nein. v1 enthält eine feste Teilmenge im Spectral-Stil, die in den Entwicklerhinweisen aufgeführt ist – keinen benutzerdefinierten Regelsatz-Runner.

Welche Vorgänge sind Linted?

Nur Pfadoperationen (get/put/post/delete/options/head/patch/trace). Webhooks und Rückrufe liegen in Version 1 außerhalb des Gültigkeitsbereichs.

Was bedeuten „Bestanden“ / „Bestanden mit Warnungen“ / „Nicht bestanden“?

fehlgeschlagen = irgendein Problem auf Fehlerebene; mit Warnungen übergeben = nur Warnungen; bestanden = keine Probleme. Wir zeigen niemals ein einfaches grünes „gültig“ an, wenn Warnungen vorliegen.

Validiert das Lint-Laufschema?

Nein. Für Lint sind openapi 3.x + Informationen und dann Stilregeln erforderlich. Verwenden Sie Validate OpenAPI für vollständige Schemakonformität.

API & Schemata

OpenAPI Tools zum Formatieren, Validieren und Flusen Ihrer Spezifikationen.

Formatieren Sie OpenAPI

OpenAPI validieren

JSON Schema zu OpenAPI

OpenAPI bis JSON Schema

JSON Schema-Validator

GraphQL validieren

Weitere Werkzeugkategorien entdecken

Minimieren

Verkleinern Sie Code und Ressourcen für die Produktion – minimieren Sie JavaScript, CSS, HTML, JSON und XML vor der Bereitstellung von gzip oder CDN.

Verschönern

Machen Sie Code mit konsistenter Einrückung lesbar – verschönern Sie JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML und mehr in Ihrem Browser.

Aufheben

Erweitern Sie minimierten oder komprimierten Code – entminifizieren Sie JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML und andere Formate beim Debuggen oder Überprüfen.

Konvertierung

Transformieren Sie Daten zwischen JSON, YAML, XML und CSV lokal – keine Server-Uploads.

CSS-Präprozessoren

Kompilieren Sie SCSS oder LESS zu Standard-CSS im Browser — kombinieren Sie mit Beautify oder Minify für einen vollständigen Stylesheet-Workflow.

JSON Werkzeuge

Validieren, formatieren, vergleichen und erkunden Sie JSON-Nutzlasten – ergänzend zu Minifiern und Konvertern.

SVG Werkzeuge

Vorschau anzeigen, mit SVGO optimieren, Daten exportieren URI, Größe ändern, verschönern, in JSX konvertieren und SVG validieren – alles in Ihrem Browser.

DevOps und Infrastruktur

Terraform HCL formatieren/validieren/minimieren, Dockerfile formatieren und lint, Docker Verfassen und .env-Validierung.

CI/CD

GitHub Aktionen und GitLab CI – formatieren Sie YAML und überprüfen Sie die Workflow-/Auftragsstruktur in Ihrem Browser.

Protokolle und Beobachtbarkeit

Zeilenorientierte JSON/NDJSON- und Nginx/Apache-Zugriffsprotokolle – formatieren, filtern, validieren und CSV/TSV.

Kubernetes

Multi-Doc-Manifeste, strukturelle Validierung, Ingress/Deployment-Starter und Helm-Werteformatierung.

Netzwerk / IP

CIDR, Subnetze und IPv4/IPv6-Helfer — im Browser.

Sicherheit und Token

JWKS, X.509-Zertifikate und Secrets-Scan – browserlokal.

Codierung

Kodieren oder dekodieren Sie Base64-, URL-Komponenten und HTML-Entitäten – nur clientseitig.

Entwickler-Dienstprogramme

Zeitstempel, UUID, ULID, Nanoid, Cron, Passwörter, Regex, Slugify, Zahlenbasen, Groß-/Kleinschreibung, Textunterschied und chmod – alles clientseitig.

Text & Markdown

Wörter zählen, Markdown-TOC erzeugen und Zeilenlisten bereinigen — im Browser.

Serialisierung

Serialisieren und deserialisieren Sie PHP-Datenstrukturen neben JSON-Workflows.