# API-Response-Contract-Validator Validiert eine echte API-Antwort gegen das in OpenAPI 3.x deklarierte Response-Schema > Kanonische Seite: https://elysiatools.com/de/tools/api-response-contract-validator - **Kategorie:** Development - **Schlagwörter:** openapi, api, antwort, schema, vertrag ## Überblick Fuegen Sie ein OpenAPI-3.x-Dokument und eine echte API-Antwort ein und geben Sie dann Pfad, Methode und Statuscode an. Das Tool loest das passende Response-Schema auf und markiert fehlende Felder, Typfehler, Enum-Verstoesse und undokumentierte Felder. So wird es genutzt: - OpenAPI-Spezifikation: YAML oder JSON einfuegen - Antwort-JSON: echte Runtime-Antwort einfuegen - Pfad / Methode / Statuscode: Operation und Antwortzweig angeben - Spec-Format: bei Unsicherheit auto lassen - Zusaetzliche Felder verbieten: warnt bei nicht dokumentierten Feldern ## Eingaben - **OpenAPI-Spezifikation** (textarea): openapi: 3.0.3 paths: /users/{id}: ... - **Antwort-JSON** (textarea): {"id":1,"name":"Alice"} - **Pfad** (text): /users/123 - **Methode** (select) - **Statuscode** (text): 200 - **Spec-Format** (select) - **Zusaetzliche Felder verbieten** (checkbox) ## Wann verwenden - Wenn Sie nach Backend-Änderungen sicherstellen müssen, dass die tatsächlichen JSON-Antworten noch der dokumentierten OpenAPI-Spezifikation entsprechen. - Bei der Fehlersuche in Frontend-Anwendungen, um zu prüfen, ob die API unerwartete Datenstrukturen oder falsche Datentypen liefert. - Während der Entwicklung von Consumer-Driven Contracts, um Mock-Daten oder Staging-Antworten gegen das offizielle Schema zu validieren. ## Funktionsweise - Fügen Sie Ihre OpenAPI 3.x-Spezifikation im YAML- oder JSON-Format in das erste Textfeld ein. - Kopieren Sie die tatsächliche JSON-Antwort Ihrer API in das Feld 'Antwort-JSON'. - Geben Sie den genauen Pfad, die HTTP-Methode und den Statuscode an, um das korrekte Schema in der Spezifikation zu lokalisieren. - Aktivieren Sie bei Bedarf 'Zusätzliche Felder verbieten', um Warnungen für nicht dokumentierte Eigenschaften zu erhalten, und starten Sie die Validierung. ## Anwendungsfälle - Automatisierte Überprüfung von Staging-APIs vor einem Produktions-Release auf Schema-Konformität. - Identifikation von fehlerhaften Datentypen (z. B. String statt Integer) in Legacy-Backend-Systemen. - Validierung von Webhook-Payloads oder Drittanbieter-APIs gegen deren offizielle Dokumentation. ## Häufig gestellte Fragen ### Welche OpenAPI-Versionen werden unterstützt? Das Tool unterstützt OpenAPI 3.x-Spezifikationen. Sie können diese sowohl im YAML- als auch im JSON-Format einfügen. ### Was passiert, wenn meine API-Antwort zusätzliche Felder enthält? Standardmäßig werden zusätzliche Felder ignoriert. Wenn Sie jedoch die Option 'Zusätzliche Felder verbieten' aktivieren, markiert das Tool diese als Fehler. ### Muss ich die gesamte OpenAPI-Spezifikation einfügen? Ja, die Spezifikation sollte vollständig genug sein, um den angegebenen Pfad, die Methode und alle referenzierten Schemata (z. B. über $ref) korrekt aufzulösen. ### Werden Datentypen strikt validiert? Ja, das Tool prüft präzise, ob Strings, Integer, Booleans und Arrays exakt den im Schema definierten Typen entsprechen. ### Wie gebe ich Pfadparameter an? Sie können den tatsächlichen Pfad wie '/users/42' eingeben. Das Tool gleicht ihn automatisch mit dem Vorlagenpfad (z. B. '/users/{id}') in der Spezifikation ab. ## Ähnliche Tools - [JSON-Schema-Generator](https://elysiatools.com/de/tools/json-schema-generator): Leitet JSON Schema aus Beispiel-JSON ab und unterstuetzt manuelle Anpassung sowie Validierung - [OCR-PDF-zu-strukturiertes-JSON-Brücke](https://elysiatools.com/de/tools/ocr-pdf-to-structured-json-bridge): Extrahiert die PDF-Textebene mit Geometrie (Zeilen nach y-Position, Tabellen nach Spaltenlücken, Überschriften nach Schriftgröße, Doppelpunkt-Schlüsselwerte) und füllt Feld für Feld ein benutzerdefiniertes JSON Schema — Labels werden über normalisierte Schlüssel gepaart, Werte zu deklarierten Typen konvertiert und mit ajv validiert. - [Short-Link + UTM + QR Bündel-Builder](https://elysiatools.com/de/tools/short-url-utm-builder-qr-bundle): Ein Durchlauf ersetzt das Trio bit.ly + Campaign Builder + QR-Generator: Ziel-URL und UTM-Parameter rein (GA4-Pflichttrio geprüft, optional Kleinschreibung), vollständige Trackings-URL raus; ein deterministischer Base62-Slug (FNV-1a-Hash, gleicher Input → gleicher Slug, ohne Konto und Netz) auf deiner Short-Domain; zwei QR-PNGs (Kurz- und Voll-Link); dazu nginx-/vercel.json-/Netlify-Redirect-Snippets und die CSV-Zeile fürs Kampagnen-Tracking. - [Train/Test-Split mit Stratifizierung](https://elysiatools.com/de/tools/train-test-split-with-stratification): Liest ein CSV/JSON-Dataset und teilt es stratifiziert nach der Zielspalte in train/validation/test (standardmäßig 70/15/15, reproduzierbarer Seed) oder stratifiziertes k-fold; Bericht zur Klassenverteilung pro Split mit Abweichungsbalken, Leck-Check über doppelte Zeilen, SMOTE-Vorschau (Nächste-Nachbarn-Interpolation auf dem Train-Split) und CSV-Export als ZIP. - [JSON Schema Validator](https://elysiatools.com/de/tools/json-schema-validator): Validiert JSON-Daten gegen ein JSON Schema, um Struktur und Datentypen zu überprüfen - [Interaktiver JSONPath-REPL](https://elysiatools.com/de/tools/jsonpath-repl-playground): Eine interaktive JSONPath-REPL, die mehrstufe Abfrage-Pipelines auf jedem JSON ausführt. Schreiben Sie einen JSONPath-Ausdruck pro Zeile (z. B. $..book\[?(@.price<10)\] dann $\[0:5\]) und sehen Sie die Treffer jedes Schritts mit Anzahlen, Pfaden und Werten — plus eine teilbare URL, die Ihre Daten und Pipeline kodiert. Unterstützt rekursiven Abstieg ($..), Wildcards (\[*\]), Filter (\[?(@.price<10)\]), Slices (\[0:5:2\]) und negative Indizes. - [OpenAPI zu Postman Collection](https://elysiatools.com/de/tools/openapi-to-postman-collection): Wandelt eine OpenAPI-3.x- oder Swagger-2.0-Spec (JSON/YAML) in eine importierbare Postman Collection v2.1.0 mit Ordnern, Variablen, Auth und Beispielantworten. - [OpenAPI-zu-TypeScript-Generator](https://elysiatools.com/de/tools/openapi-to-typescript-generator): Konvertiert OpenAPI- oder Swagger-Spezifikationen in JSON/YAML in TypeScript-API-Typen, Anfrageparameter und Antwortmodelle mit konfigurierbarem Ausgabeformat und Namensstil ## Beispiele - [Postman Collections - API Tests](https://elysiatools.com/de/samples/postman-collections): Umfassende Postman Collection Beispiele inklusive API Tests, Automatisierungsskripte, Umgebungsvariablen, Mock Server und fortgeschrittene Testmuster für REST APIs - [AWS EventBridge Beispiele](https://elysiatools.com/de/samples/eventbridge-samples): AWS EventBridge Beispiele einschließlich Event Buses, Rules, Targets, Schema Registry, Custom Events und Cross-Account Event Routing für Serverless Event-Driven Architecture - [OpenAPI/Swagger Beispiele](https://elysiatools.com/de/samples/openapi-swagger): Umfassende API-Dokumentationsbeispiele mit OpenAPI 3.0 und Swagger-Spezifikationen für RESTful-Services - [Distributed Tracing Beispiele](https://elysiatools.com/de/samples/distributed-tracing-samples): Umfassende Beispiele für verteiltes Tracing mit Jaeger, OpenTelemetry und modernen Observability Tools ## Verwandte Inhalte - [API-Verträge definieren, Schemas validieren und Änderungen testen](https://elysiatools.com/de/hubs/api-contract-testing): Definieren Sie einen API-Vertrag, prüfen Sie Schemas und aufgezeichnete Payloads, erkennen Sie Kompatibilitätsrisiken und dokumentieren Sie die Abnahme. - [API-Versionierung und Pruefung von Breaking Changes](https://elysiatools.com/de/hubs/api-versioning-breaking-change-review): Vergleichen Sie API-Versionen, planen Sie Migrationen und nehmen Sie die Kompatibilitaet vor dem Release ab. Die Tools ersetzen weder echtes Deployment noch Monitoring. - [JSON Utility-, Inspektions- und Transformationswerkzeuge](https://elysiatools.com/de/hubs/json-utility): JSON-Payloads fuer API- und Datenworkflows formatieren, pruefen, vergleichen, zusammenfuehren, transformieren, validieren, analysieren und markieren. - [JSON-Schema- und API-Vertragsvalidierungs-Tools](https://elysiatools.com/de/hubs/json-validate): Vergleichen Sie JSON-Schema-Validierung, OpenAPI-Response-Prüfung, Mutation Testing, Stress Testing und Breaking-Change-Erkennung in einem Hub für API-Vertragsreviews.