Πώς να Χρησιμοποιήσετε το JSON Schema για να Επικυρώσετε τα Δεδομένα σας

By Ομάδα JSONValidator.dev 2025-07-04

Τι είναι το JSON Schema;

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

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

Γιατί να Επικυρώσετε με Schema;

  • Αποφύγετε σφάλματα εντοπίζοντας μη έγκυρα ή ελλιπή δεδομένα προτού προκαλέσουν προβλήματα.
  • Εξασφαλίστε συνεπείς πληροφορίες ανάμεσα σε ομάδες, εφαρμογές ή API.
  • Δημιουργήστε αυτόματα τεκμηρίωση από τα schemas.
  • Βοηθήστε επεξεργαστές και εργαλεία να παρέχουν καλύτερη αυτόματη συμπλήρωση και βοήθεια εντός του κώδικα.
Ακόμα και ένα απλό schema μπορεί να εντοπίσει κοινά λάθη, εξοικονομώντας πολύτιμο χρόνο αποσφαλμάτωσης.

Απλό Παράδειγμα: Βασικό Schema

Ακολουθεί ένα βασικό JSON αντικείμενο, ακολουθούμενο από ένα ελάχιστο schema που επικυρώνει τη δομή του:

{
  "name": "Alice",
  "age": 30
}
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

Αυτό το schema διασφαλίζει ότι το αντικείμενο πρέπει να έχει πεδίο 'name' τύπου string και πεδίο 'age' τύπου αριθμού.

Πώς να Δημιουργήσετε ένα Προσαρμοσμένο Schema

Μπορείτε να ορίσετε πιο σύνθετους κανόνες στο schema σας: να περιορίσετε τις τιμές πεδίων, να ορίσετε εμφωλευμένα αντικείμενα ή να καθορίσετε ελάχιστα/μέγιστα όρια σε αριθμούς. Ακολουθεί ένα παράδειγμα που επικυρώνει έναν πίνακα προϊόντων:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Ξεκινήστε απλά: χτίστε σταδιακά το schema σας και χρησιμοποιήστε διαδικτυακούς επικυρωτές για έλεγχο σε κάθε βήμα.

Χρήση του JSONValidator.dev για Επικύρωση Schema

  1. Επικολλήστε τα JSON δεδομένα σας στον κύριο επεξεργαστή.
  2. Επικολλήστε το JSON Schema σας στον επεξεργαστή schema παρακάτω.
  3. Πατήστε Επικύρωση JSON με Αυτό το Schema.
  4. Εξετάστε τα αποτελέσματα επικύρωσης, με οποιαδήποτε λάθη επισημασμένα και εξηγημένα.
Όλη η επικύρωση γίνεται στον browser σας – τα δεδομένα σας δεν αποστέλλονται πουθενά.

Επίλυση Προβλημάτων με Σφάλματα Επικύρωσης Schema

Συνηθισμένες αιτίες σφαλμάτων επικύρωσης είναι:

  • Απουσιάζει κάποιο απαιτούμενο πεδίο στα δεδομένα σας.
  • Ο τύπος τιμής δεν ταιριάζει με το schema (π.χ., string αντί αριθμού).
  • Το ίδιο το schema είναι μη έγκυρο ή περιέχει ορθογραφικά λάθη.
Ελέγξτε προσεκτικά τα μηνύματα λάθους — συχνά υποδεικνύουν το ακριβές πεδίο και τον τύπο που δεν ταιριάζει.

Συμπέρασμα

Η επικύρωση με JSON Schema είναι ένας ισχυρός τρόπος να κάνετε τα δεδομένα σας σταθερά και χωρίς λάθη. Δοκιμάστε να δημιουργήσετε ένα schema για τα δικά σας δεδομένα με τον δωρεάν Γεννήτρια JSON Schema μας και επαληθεύστε το άμεσα!