Τι είναι το σχήμα JSON;

Το σχήμα JSON (JSON Schema) είναι ένα λεξικό πρότυπο βασισμένο σε JSON για την περιγραφή της δομής και των περιορισμών των δεδομένων σε μορφή JSON. Επιτρέπει την επικύρωση, την περιγραφή και την τεκμηρίωση δεδομένων JSON.

Κύριοι στόχοι:

• Επικύρωση: Έλεγχος αν μια JSON παρουσία ταιριάζει με μια καθορισμένη δομή.
• Τεκμηρίωση: Περιγραφή της μορφής των δεδομένων JSON.
• Αλληλεπίδραση: Ανταλλαγή μεταδεδομένων μεταξύ συστημάτων.

Βασικά στοιχεία του σχήματος JSON:

• Τύποι δεδομένων: string, number, integer, boolean, object, array, null.
• Λέξεις-κλειδιά για περιορισμούς:
  • type: Αναμενόμενος τύπος δεδομένων.
  • properties: Περιγραφή των ιδιοτήτων ενός αντικειμένου. Κάθε ιδιότητα έχει το δικό της υπο-σχήμα.
  • required: Λίστα υποχρεωτικών ιδιοτήτων.
  • items: Περιγραφή των στοιχείων ενός πίνακα.
  • minLength/maxLength: Περιορισμοί μήκους για συμβολοσειρές.
  • minimum/maximum: Περιορισμοί για αριθμούς.
  • pattern: Κανονική έκφραση για συμβολοσειρές.
  • enum: Λίστα επιτρεπτών τιμών.
  • allOf/anyOf/oneOf/not: Λογικοί συνδυασμοί σχημάτων.
• Λέξεις-κλειδιά για μεταδεδομένα:
  • title: Σύντομος τίτλος του σχήματος.
  • description: Αναλυτική περιγραφή του σχήματος.
  • default: Προεπιλεγμένη τιμή.

Παράδειγμα JSON σχήματος:

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Μοναδικός αναγνωριστικός χρήστη"
    },
    "username": {
      "type": "string",
      "minLength": 3
    },
    "isActive": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "id",
    "username"
  ]
}

Παράδειγμα έγκυρων δεδομένων JSON σύμφωνα με αυτό το σχήμα:

{
  "id": 123,
  "username": "testuser",
  "isActive": false
}

Παράδειγμα μη έγκυρων δεδομένων JSON:

{
  "id": "abc" // Λάθος τύπος
  // Απαιτούμενο πεδίο "username" λείπει
}

Χρήση του JSON Schema στην QA Automation:

• Επικύρωση απαντήσεων API: Έλεγχος αν οι απαντήσεις JSON ταιριάζουν με το φορμάτ.
• Επικύρωση αιτημάτων: Έλεγχος των εισερχόμενων δεδομένων JSON πριν από την επεξεργασία.
• Γεννήτρια δοκιμαστικών δεδομένων: Χρήση του σχήματος για τη δημιουργία έγκυρων (ή μη) παραδειγμάτων.
• Τεκμηρίωση: Δημιουργία αυτόματα ενημερωμένης τεκμηρίωσης API.

Υπάρχουν βιβλιοθήκες για εργασία με JSON schemas σε διάφορες γλώσσες προγραμματισμού (π.χ., jsonschema για Python, json-schema-validator για Java).