Podporované typy a schémy JSON
Na tejto strane
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ú
anyOfsnull - Žiadny rozdiel medzi celým a desatinným číslom – existuje len jeden typ
number enumvynucuje preddefinované hodnoty pre klasifikácie