Επικύρωση JSON Schema

Πώς να επικυρώσετε JSON με ένα schema

1. Επικολλήστε το schema σας στο JSON Schema και τα δεδομένα σας στο Έγγραφο JSON, ή διαλέξτε μια έτοιμη περίπτωση από το Παράδειγμα.
2. Αφήστε την Έκδοση (draft) στο Αυτόματη ($schema) για να χρησιμοποιηθεί η έκδοση που ορίζει το $schema του schema, ή επιβάλετε draft 4, 7, 2019-09 ή 2020-12.
3. Η επικύρωση εκτελείται καθώς πληκτρολογείτε· το Επικύρωση την εκτελεί ξανά. Το Μορφοποίηση και των δύο ξαναμορφοποιεί τα δύο κείμενα.
4. Διαβάστε το αποτέλεσμα: μια πράσινη γραμμή όταν το έγγραφο είναι έγκυρο, αλλιώς ένας πίνακας σφαλμάτων.

Τα μηνύματα σφαλμάτων του επικυρωτή εμφανίζονται στα αγγλικά· τα υπόλοιπα στοιχεία της σελίδας είναι στα ελληνικά.

Ανάγνωση του πίνακα σφαλμάτων

Κάθε γραμμή είναι ένας κανόνας που απέτυχε:

• Η Διαδρομή στιγμιότυπου είναι ένας δείκτης JSON Pointer προς την τιμή που απέτυχε. Το /roles/1 είναι το δεύτερο στοιχείο του roles· το (ρίζα) είναι ολόκληρο το έγγραφο.
• Η Λέξη-κλειδί είναι ο κανόνας του schema που απέτυχε: type, required, minimum, pattern, format, additionalProperties κ.ο.κ.
• Το Μήνυμα εξηγεί την αποτυχία, για παράδειγμα 0 is less than 1.
• Η Διαδρομή στο schema δείχνει τη λέξη-κλειδί μέσα στο schema, όπως το /properties/id/minimum, ώστε να βρείτε γρήγορα τον κανόνα.

Η επικύρωση δεν σταματά στο πρώτο πρόβλημα: καταγράφονται όλα τα σφάλματα. Όταν αποτυγχάνει μια ιδιότητα αντικειμένου, ο επικυρωτής αναφέρει μια σύνοψη («Property “id” does not match schema») και μετά τον ακριβή λόγο. Το Εμφάνιση μόνο των πιο συγκεκριμένων σφαλμάτων κρύβει αυτές τις συνόψεις· αποεπιλέξτε το για να δείτε ολόκληρη την αλυσίδα. Τα σφάλματα κάτω από τα anyOf και oneOf διατηρούνται πάντα μαζί με τα συγκεκριμένα σφάλματα κάθε κλάδου, επειδή έχουν νόημα μόνο μαζί.

Τι υποστηρίζεται

• Εκδόσεις (drafts): 4, 6 (επικυρώνεται με τους κανόνες του draft 7), 7, 2019-09 και 2020-12, συμπεριλαμβανομένων των $defs/definitions, τοπικού $ref, if/then/else, dependentRequired, dependentSchemas, prefixItems, unevaluatedProperties και unevaluatedItems.
• Μορφές (formats): ελέγχονται οι date, time, date-time, duration, email, hostname, ipv4, ipv6, uri, uri-reference, uri-template, uuid, regex, json-pointer και relative-json-pointer. Οι άγνωστες μορφές αγνοούνται, όπως επιτρέπει η προδιαγραφή.
• Αναφορές: το $ref μπορεί να δείχνει οπουδήποτε μέσα στο schema, μεταξύ άλλων σε ένα $id που δηλώνει. Τα απομακρυσμένα schemas δεν κατεβαίνουν ποτέ· μια αναφορά σε άλλο URL αναφέρεται ως μη επιλύσιμη.

Το εργαλείο επικυρώνει έγγραφα ως προς το schema σας. Δεν ελέγχει αν το ίδιο το schema ακολουθεί το meta-schema, αλλά προειδοποιεί για άγνωστα ονόματα type όπως "strin" ή "int", μια συνηθισμένη γραφή που οι επικυρωτές αλλιώς αγνοούν σιωπηλά.

Τα παραδείγματα

• Προφίλ χρήστη (2020-12): required, μήκη συμβολοσειρών, format: email, ένα enum μέσα σε items, uniqueItems και additionalProperties: false.
• Λίστα προϊόντων με $ref (draft-07): ένας πίνακας του οποίου τα στοιχεία αναφέρονται στο #/definitions/product, με pattern για το SKU και τιμή με exclusiveMinimum.
• Ρυθμίσεις με if/then (2019-09): ένα πιστοποιητικό που απαιτείται μόνο στη λειτουργία HTTPS, ένα oneOf ανάμεσα σε email και URI, και αριθμητικά όρια.

Κάθε παράδειγμα συνοδεύεται από ένα έγγραφο με εσκεμμένα λάθη, ώστε να δείτε πώς μοιάζουν τα σφάλματα.