Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Toetatud tüübid ja JSONi skeemid

Õppetund 2 / 12 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Sinu skeemide ehitusplokid
  2. Seitse toetatud tüüpi
  3. Tüüpide kombineerimine
  4. Valikulised väljad
  5. Peamised punktid

Sinu skeemide ehitusplokid

Vastuste struktuuri määratlemiseks on sul kasutada seitse JSONi tüüpi. Igaüks neist täidab andmete modelleerimisel kindlat eesmärki. Nende tüüpide mõistmine on hädavajalik tõhusate skeemide loomiseks.

Seitse toetatud tüüpi

string

Kõige levinum tüüp. Kasutatakse nimede, kirjelduste, identifikaatorite ja igasuguse tekstisisu jaoks.

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "description": { "type": "string" }
  }
}

number

Hõlmab nii täisarve kui ka ujukomaarve. Erinevust integer ja float vahel ei tehta – mõlemat haldab üksainus number tüüp.

{
  "properties": {
    "price": { "type": "number" },
    "quantity": { "type": "number" }
  }
}

boolean

Tõene või väär. Ideaalne lipukeste, valideerimiste ja binaarsete otsuste jaoks.

{
  "properties": {
    "in_stock": { "type": "boolean" },
    "express_delivery": { "type": "boolean" }
  }
}

object

Võimaldab struktuure pesastada. Objekt võib sisaldada teisi objekte, massiive või skalaare – sügavuse piirangut pole.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "street": { "type": "string" },
        "city": { "type": "string" },
        "postal_code": { "type": "string" }
      }
    }
  }
}

array

Sama tüüpi elementide loendid. Sul võivad olla stringide, arvude, objektide või isegi massiivide massiivid.

{
  "properties": {
    "skills": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

enum

Lõplik lubatud väärtuste hulk. Hädavajalik kategoriseerimiseks ja klassifitseerimiseks.

{
  "properties": {
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    }
  }
}

anyOf

Võimaldab defineerida tüüpide liite. Väli võib aktsepteerida mitut erinevat struktuuri. Kasulik juhtudel, kui üks väli võib võtta erinevaid vorme.

{
  "properties": {
    "contact": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "email": { "type": "string" }
          }
        },
        {
          "type": "object",
          "properties": {
            "phone": { "type": "string" }
          }
        }
      ]
    }
  }
}

Tüüpide kombineerimine

Skeemide jõudlus seisneb nende tüüpide kombineerimises. Siin on realistlik skeem toote analüüsimiseks:

{
  "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" }
      }
    }
  }
}

See skeem ühendab skalaare, loetelu (enum), massiivi ja pesastatud objekti. Mudel järgib igas väljakutses iga piirangut.

Valikulised väljad

Välja valikuliseks muutmiseks kasuta anyOf koos null-iga:

{
  "properties": {
    "phone": {
      "anyOf": [
        { "type": "string" },
        { "type": "null" }
      ]
    }
  }
}

Pydanticus vastab sellele phone: str | None.

Peamised punktid

  • Seitse saadaolevat tüüpi: string, number, object, array, boolean, enum, anyOf
  • Tüüpe saab vabalt kombineerida keerukate struktuuride modelleerimiseks
  • Valikulised väljad kasutavad anyOf koos null-iga
  • Täisarvu ja ujukomaarvu vahel vahet ei tehta – kasutatakse ühtset number tüüpi
  • enum sunnib kasutama eelmääratletud väärtusi klassifitseerimisel