Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Podporované typy a schémy JSON

Lekcia 2 z 12 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Stavebné kamene tvojich schém
  2. Sedem podporovaných typov
  3. Kombinovanie typov
  4. Voliteľné polia
  5. Kľúčové poznatky

Stavebné kamene tvojich schém

Na definovanie štruktúry svojich odpovedí máš k dispozícii sedem typov JSON. Každý z nich slúži na konkrétne potreby pri modelovaní tvojich dát. Pochopenie týchto typov je nevyhnutné pre navrhovanie efektívnych schém.

Sedem podporovaných typov

string

Najbežnejší typ. Používa sa na mená, popisy, identifikátory a akýkoľvek textový obsah.

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

number

Pokrýva celé čísla aj desatinné čísla. Neexistuje rozdiel medzi integer a float – jeden typ number zvládne obe.

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

boolean

Pravda alebo nepravda. Ideálne pre príznaky, validácie a binárne rozhodnutia.

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

object

Umožňuje vnáranie štruktúr. Objekt môže obsahovať iné objekty, polia alebo skalárne hodnoty – bez obmedzenia hĺbky.

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

array

Zoznamy prvkov rovnakého typu. Môžeš mať polia reťazcov, čísel, objektov alebo dokonca polí.

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

enum

Konečná množina povolených hodnôt. Nevyhnutné pre kategorizácie a klasifikácie.

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

anyOf

Umožňuje definovať zjednotenia typov. Pole môže akceptovať niekoľko rôznych štruktúr. Užitočné, keď môže jedno pole nadobúdať rôzne formy.

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

Kombinovanie typov

Silu schém získavaš kombinovaním týchto typov. Tu je realistická schéma na analýzu produktu:

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

Táto schéma mieša skalárne typy, enum, pole a vnorený objekt. Model bude rešpektovať každé obmedzenie pri každom volaní.

Voliteľné polia

Ak chceš urobiť pole voliteľným, použi anyOf s hodnotou null:

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

V Pydantic to zodpovedá phone: str | None.

Kľúčové poznatky

  • Sedem dostupných typov: string, number, object, array, boolean, enum, anyOf
  • Typy sa voľne kombinujú na modelovanie zložitých štruktúr
  • Voliteľné polia používajú anyOf s null
  • Žiadny rozdiel medzi celým a desatinným číslom – existuje len jeden typ number
  • enum vynucuje preddefinované hodnoty pre klasifikácie