Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Podržani tipovi i JSON sheme

Lekcija 2 od 12 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Gradivni blokovi tvojih shema
  2. Sedam podržanih tipova
  3. Kombiniranje tipova
  4. Opcionalna polja
  5. Ključne točke

Gradivni blokovi tvojih shema

Za definiranje strukture svojih odgovora imaš na raspolaganju sedam JSON tipova. Svaki od njih služi specifičnoj potrebi u modeliranju tvojih podataka. Razumijevanje ovih tipova ključno je za dizajniranje učinkovitih shema.

Sedam podržanih tipova

string

Najčešći tip. Koristi se za imena, opise, identifikatore i bilo kakav tekstualni sadržaj.

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

number

Obuhvaća cijele brojeve i brojeve s pomičnim zarezom. Ne postoji razlika između integer i float — jedan jedinstveni tip number obrađuje oboje.

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

boolean

Točno ili netočno. Savršeno za oznake, validacije i binarne odluke.

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

object

Omogućuje ti ugnježđivanje struktura. Objekt može sadržavati druge objekte, polja ili skalare — bez ograničenja dubine.

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

array

Popisi elemenata istog tipa. Možeš imati polja stringova, brojeva, objekata, pa čak i drugih polja.

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

enum

Konačan skup dopuštenih vrijednosti. Ključan za kategorizacije i klasifikacije.

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

anyOf

Omogućuje ti definiranje unija tipova. Polje može prihvatiti nekoliko različitih struktura. Korisno kada jedno polje može poprimiti različite oblike.

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

Kombiniranje tipova

Snaga shema proizlazi iz kombiniranja ovih tipova. Evo realistične sheme za analizu proizvoda:

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

Ova shema miješa skalare, enum, polje i ugniježđeni objekt. Model će poštovati svako ograničenje pri svakom pozivu.

Opcionalna polja

Da bi polje učinio opcionalnim, upotrijebi anyOf s null:

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

U Pydanticu to odgovara phone: str | None.

Ključne točke

  • Sedam dostupnih tipova: string, number, object, array, boolean, enum, anyOf
  • Tipovi se slobodno kombiniraju za modeliranje složenih struktura
  • Opcionalna polja koriste anyOf s null
  • Nema razlike između cijelog broja i broja s pomičnim zarezom — postoji samo jedan tip number
  • enum nameće unaprijed definirane vrijednosti za klasifikacije