Cluster C1: JSON-Ökosystem
JSON-Schema-Validierungscheckliste
Vor API- oder Konfigurationsänderungen hilft diese Checkliste, Pflichtfelder, Beispiele und Regressionstests mit JSON Schema sauber abzusichern.
Den Vertrag zuerst festziehen
Ein Schema ist nicht nur dafür da, einen Validator zufriedenzustellen. Es definiert gemeinsam verstandene Regeln für Pflichtfelder, Nullable-Verhalten und erlaubte Werte.
Wenn Dokumentation, Beispielpayloads und echte Laufzeitregeln auseinanderlaufen, tauchen Fehler meist erst in Integration oder Release auf.
Diese Punkte sollten immer geprüft werden
- required, type, enum und format müssen zu den echten API-Anforderungen passen.
- Für verschachtelte Objekte und Arrays braucht es mindestens ein gültiges und ein ungültiges Beispiel.
- Schema-Prüfungen gehören in CI, damit Feldregressionen nicht nur manuell entdeckt werden.
Praktisches Ein-/Ausgabe-Beispiel
Eingabe
{
"type": "object",
"required": ["id", "status"],
"properties": {
"id": { "type": "string" },
"status": { "enum": ["ready", "failed"] }
}
}Ausgabe
Validierung: - payload.id fehlt -> Fehler - payload.status darf nur ready oder failed sein