Podržani tipovi i JSON sheme
Na ovoj stranici
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
anyOfsnull - Nema razlike između cijelog broja i broja s pomičnim zarezom — postoji samo jedan tip
number enumnameće unaprijed definirane vrijednosti za klasifikacije