Toetatud tüübid ja JSONi skeemid
Sellel lehel
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
anyOfkoosnull-iga - Täisarvu ja ujukomaarvu vahel vahet ei tehta – kasutatakse ühtset
numbertüüpi enumsunnib kasutama eelmääratletud väärtusi klassifitseerimisel