Υποστηριζόμενοι Τύποι και Σχήματα JSON
Σε αυτήν τη σελίδα
Τα δομικά στοιχεία των σχημάτων σας
Για να ορίσετε τη δομή των απαντήσεών σας, έχετε στη διάθεσή σας επτά τύπους JSON. Ο καθένας εξυπηρετεί μια συγκεκριμένη ανάγκη κατά τη μοντελοποίηση των δεδομένων σας. Η κατανόηση αυτών των τύπων είναι απαραίτητη για τον σχεδιασμό αποτελεσματικών σχημάτων.
Οι επτά υποστηριζόμενοι τύποι
string
Ο πιο συνηθισμένος τύπος. Χρησιμοποιείται για ονόματα, περιγραφές, αναγνωριστικά και οποιοδήποτε κειμενικό περιεχόμενο.
{
"type": "object",
"properties": {
"name": { "type": "string" },
"description": { "type": "string" }
}
}
number
Καλύπτει ακέραιους και δεκαδικούς αριθμούς. Δεν υπάρχει διάκριση μεταξύ integer και float — ένας ενιαίος τύπος number διαχειρίζεται και τα δύο.
{
"properties": {
"price": { "type": "number" },
"quantity": { "type": "number" }
}
}
boolean
Αληθές ή ψευδές. Ιδανικό για σημαίες (flags), επικυρώσεις και δυαδικές αποφάσεις.
{
"properties": {
"in_stock": { "type": "boolean" },
"express_delivery": { "type": "boolean" }
}
}
object
Σας επιτρέπει να εμφωλεύετε δομές. Ένα αντικείμενο μπορεί να περιέχει άλλα αντικείμενα, πίνακες ή βαθμωτές τιμές — χωρίς όριο βάθους.
{
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"street": { "type": "string" },
"city": { "type": "string" },
"postal_code": { "type": "string" }
}
}
}
}
array
Λίστες στοιχείων του ίδιου τύπου. Μπορείτε να έχετε πίνακες από strings, αριθμούς, αντικείμενα ή ακόμη και άλλους πίνακες.
{
"properties": {
"skills": {
"type": "array",
"items": { "type": "string" }
}
}
}
enum
Ένα πεπερασμένο σύνολο επιτρεπόμενων τιμών. Απαραίτητο για κατηγοριοποιήσεις και ταξινομήσεις.
{
"properties": {
"priority": {
"type": "string",
"enum": ["low", "medium", "high", "critical"]
}
}
}
anyOf
Σας επιτρέπει να ορίζετε ενώσεις τύπων (type unions). Ένα πεδίο μπορεί να δέχεται πολλές διαφορετικές δομές. Χρήσιμο όταν ένα μοναδικό πεδίο μπορεί να λάβει ποικίλες μορφές.
{
"properties": {
"contact": {
"anyOf": [
{
"type": "object",
"properties": {
"email": { "type": "string" }
}
},
{
"type": "object",
"properties": {
"phone": { "type": "string" }
}
}
]
}
}
}
Συνδυασμός τύπων
Η δύναμη των σχημάτων πηγάζει από τον συνδυασμό αυτών των τύπων. Ακολουθεί ένα ρεαλιστικό σχήμα για την ανάλυση ενός προϊόντος:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"price": { "type": "number" },
"in_stock": { "type": "boolean" },
"category": {
"type": "string",
"enum": ["electronics", "clothing", "grocery", "other"]
},
"tags": {
"type": "array",
"items": { "type": "string" }
},
"manufacturer": {
"type": "object",
"properties": {
"name": { "type": "string" },
"country": { "type": "string" }
}
}
}
}
Αυτό το σχήμα αναμειγνύει βαθμωτές τιμές, ένα enum, έναν πίνακα και ένα εμφωλευμένο αντικείμενο. Το μοντέλο θα σέβεται κάθε περιορισμό σε κάθε κλήση.
Προαιρετικά πεδία
Για να κάνετε ένα πεδίο προαιρετικό, χρησιμοποιήστε το anyOf με την τιμή null:
{
"properties": {
"phone": {
"anyOf": [
{ "type": "string" },
{ "type": "null" }
]
}
}
}
Στο Pydantic, αυτό αντιστοιχεί στο phone: str | None.
Βασικά σημεία
- Επτά διαθέσιμοι τύποι:
string,number,object,array,boolean,enum,anyOf - Οι τύποι συνδυάζονται ελεύθερα για τη μοντελοποίηση πολύπλοκων δομών
- Τα προαιρετικά πεδία χρησιμοποιούν το
anyOfμε την τιμήnull - Δεν υπάρχει διάκριση ακέραιου/δεκαδικού — ένας ενιαίος τύπος
number - Το
enumεπιβάλλει προκαθορισμένες τιμές για ταξινομήσεις