Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Υποστηριζόμενοι Τύποι και Σχήματα JSON

Μάθημα 2 / 12 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Τα δομικά στοιχεία των σχημάτων σας
  2. Οι επτά υποστηριζόμενοι τύποι
  3. Συνδυασμός τύπων
  4. Προαιρετικά πεδία
  5. Βασικά σημεία

Τα δομικά στοιχεία των σχημάτων σας

Για να ορίσετε τη δομή των απαντήσεών σας, έχετε στη διάθεσή σας επτά τύπους 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 επιβάλλει προκαθορισμένες τιμές για ταξινομήσεις