VoriTools

JSON-API-Antworten prüfen

Fügen Sie Schema und Antwort für den kopierbaren Bericht ein. Geprüft werden die unterstützten Regeln an vorhandenen Daten; es erfolgt kein API-Aufruf.

Läuft lokal in deinem Browser
Kategorie ansehen: API-Entwicklung (15)
Schema und Antwort werden vollständig in diesem Browser validiert. Weder Payload und Kontodaten noch API-Zugangsdaten verlassen die Seite.
JSON Schema
Aufgezeichnete API-Antwort
Validierungsübersicht

Unterstützte Regeln umfassen lokale Referenzen $ref, type, Objekteigenschaften, Pflichtfelder, Arrays, Enums, const, Formate, Längen, Muster, Bereiche und gängige Kombinationsregeln.

Validierungsergebnisse
  • Fügen Sie ein JSON Schema und eine API-Antwort zur Validierung ein.

Response-Verträge ohne Test-Runner validieren

Dies ist eine browserseitige Vertragshilfe für Fixtures und aufgezeichnete Antworten. Prüfen Sie erweitertes JSON-Schema-Vokabular, Remote-Referenzen und das Verhalten der Produktionsintegration in Ihrer eigenen API-Testsuite.

So wird eine API-Antwort geprüft

Fügen Sie das zugesagte JSON-Schema und eine erfasste JSON-Antwort ein und wählen Sie „Antwort validieren“: Die Seite listet jede verletzte Regel mit ihrem JSON-Pointer-Pfad auf und zeigt drei Übersichtskarten (Ergebnis, Anzahl der Fehler, Antworttyp).

Schema und Antwort werden in der Seite selbst gelesen und geprüft. Keine Anfrage trägt sie nach außen, die getestete API wird nie aufgerufen, und der Prüfer deckt eine dokumentierte Teilmenge von JSON Schema ab statt eines vollständigen Draft-Validators.

  1. Fügen Sie das erwartete JSON-Schema links ein, oder wählen Sie „Beispiel laden“, um beide Felder mit einem kleinen Vertrag (id, email und roles erforderlich) zu füllen und ihn sofort zu prüfen.
  2. Fügen Sie die erfasste JSON-Antwort rechts ein. Das JSON wird vor jeder Regel ausgewertet, daher wird ein fehlerhaftes Payload als Analysefehler gemeldet, statt Prüfungen zu erzeugen.
  3. Wählen Sie „Antwort validieren“. Jeder Befund verbindet eine Stufe (OK oder Fehler), einen JSON-Pointer-Pfad wie $/roles/0 und einen Satz; die Karten zeigen Gültig/Ungültig, die Zahl der Fehler und den Antworttyp.
  4. Mit „Bericht kopieren“ kopieren Sie die Befunde als Klartext, mit „Leeren“ setzen Sie beide Felder, Übersicht, Befunde und die Kopierschaltfläche zurück; ein leeres Feld zeigt einen Hinweis in Ihrer Sprache.

Was der Prüfer auswertet – und was er überspringt

Regeln, die geprüft werden

Typen (einschließlich integer), Pflichtfelder, additionalProperties (false oder ein Schema), enum und const mit tiefem Vergleich, die Formate email, uuid, date, date-time, uri, uri-reference, hostname und ipv4 sowie minLength/maxLength/pattern, minimum/maximum/exclusiveMinimum/exclusiveMaximum in numerischer und Boolescher Draft-4-Form, multipleOf, minItems/maxItems/uniqueItems mit einem einzelnen items-Schema, minProperties/maxProperties und allOf/anyOf/oneOf.

Lokale Referenzen werden im selben Dokument aufgelöst: #, #/$defs/... und #/definitions/... . Pfade sind JSON Pointer: $ ist die Wurzel, /0 das erste Array-Element, und / und ~ in Eigenschaftsnamen werden als ~1 und ~0 geschrieben. Unbekannte Formate werden ignoriert, und die Prüfung stoppt bei 60 Verschachtelungsebenen mit einer klaren Meldung.

Regeln, die nicht geprüft werden

Ein $ref, das nicht mit # beginnt, wird als nicht auflösbar gemeldet statt abgerufen; entfernte Schemata werden also nicht geladen. Die Tupelform von items (ein Array aus Schemata), if/then/else, dependencies, patternProperties, propertyNames und Schlüsselwörter zur Inhaltskodierung liegen außerhalb der umgesetzten Teilmenge; unbekannte Schlüsselwörter werden einfach übersprungen.

Die Seite sendet das Payload nie an einen Server und führt es nie aus; sie ist eine Prüfhilfe für Fixtures und erfasste Antworten, kein Konformitätstest. Für draft-spezifisches Verhalten oder Freigaben in der Produktion nutzen Sie einen vollständigen Validator in Ihrer eigenen Testsuite.

Bericht lesen und kopieren

Die drei Karten zählen die Schemafehler und zeigen den JSON-Typ der Antwort (object, array, string, number, integer, boolean, null). Befunde stehen in der Reihenfolge ihres Auftretens; wenn nichts fehlschlägt, zeigt die Liste einen einzigen OK-Eintrag.

„Bericht kopieren“ kopiert Zeilen wie [ERROR] $/id — Erwartet string, erhalten integer., die sich in ein Ticket oder eine Commit-Nachricht einfügen lassen. Nichts wird gespeichert: „Leeren“ setzt die Seite zurück, und nach dem Neuladen startet die Werkbank wieder leer.

Zuletzt verwendet: