Tipi Appoġġjati u Skemi JSON
F'din il-paġna
Il-blokki tal-bini tal-iskemi tiegħek
Biex tiddefinixxi l-istruttura tar-risposti tiegħek, għandek seba’ tipi JSON. Kull wieħed iservi ħtieġa speċifika fil-mudellar tad-data tiegħek. Li tifhem dawn it-tipi huwa essenzjali biex tfassal skemi effettivi.
Is-seba’ tipi appoġġjati
string
L-aktar tip komuni. Użat għal ismijiet, deskrizzjonijiet, identifikaturi, u kwalunkwe kontenut ta’ test.
{
"type": "object",
"properties": {
"name": { "type": "string" },
"description": { "type": "string" }
}
}
number
Jkopri l-interi u l-floats. L-ebda distinzjoni bejn integer u float — tip wieħed number jimmaniġġja t-tnejn.
{
"properties": {
"price": { "type": "number" },
"quantity": { "type": "number" }
}
}
boolean
Veru jew falz. Perfett għal flag, validazzjonijiet, u deċiżjonijiet binarji.
{
"properties": {
"in_stock": { "type": "boolean" },
"express_delivery": { "type": "boolean" }
}
}
object
Jħallik tpoġġi strutturi f’xulxin (nesting). Oġġett jista’ jkun fih oġġetti oħra, arrays, jew skalars — mingħajr limitu ta’ fond.
{
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"street": { "type": "string" },
"city": { "type": "string" },
"postal_code": { "type": "string" }
}
}
}
}
array
Listi ta’ elementi tal-istess tip. Tista’ jkollok arrays ta’ strings, numri, oġġetti, jew saħansitra arrays oħra.
{
"properties": {
"skills": {
"type": "array",
"items": { "type": "string" }
}
}
}
enum
Sett finit ta’ valuri permessi. Essenzjali għall-kategorizzazzjonijiet u l-klassifikazzjonijiet.
{
"properties": {
"priority": {
"type": "string",
"enum": ["low", "medium", "high", "critical"]
}
}
}
anyOf
Jħallik tiddefinixxi unionijiet ta’ tipi. Kamp jista’ jaċċetta diversi strutturi differenti. Utli meta kamp wieħed jista’ jieħu forom varjati.
{
"properties": {
"contact": {
"anyOf": [
{
"type": "object",
"properties": {
"email": { "type": "string" }
}
},
{
"type": "object",
"properties": {
"phone": { "type": "string" }
}
}
]
}
}
}
Il-kombinazzjoni tat-tipi
Is-saħħa tal-iskemi ġejja mill-kombinazzjoni ta’ dawn it-tipi. Hawnhekk hemm skema realistika biex tanalizza prodott:
{
"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" }
}
}
}
}
Din l-iskema tħallat skalars, enum, array, u oġġett imbejjen (nested). Il-mudell se jirrispetta kull restrizzjoni fuq kull sejħa.
Kampijiet fakultattivi
Biex tagħmel kamp fakultattiv, uża anyOf ma’ null:
{
"properties": {
"phone": {
"anyOf": [
{ "type": "string" },
{ "type": "null" }
]
}
}
}
F’Pydantic, dan jikkorrispondi għal phone: str | None.
Punti Ewlenin
- Seba’ tipi disponibbli:
string,number,object,array,boolean,enum,anyOf - It-tipi jingħaqdu liberament biex jimmodellaw strutturi kumplessi
- Il-kampijiet fakultattivi jużaw
anyOfma’null - L-ebda distinzjoni bejn integer/float — tip wieħed
number enumjinfurza valuri predefiniti għall-klassifikazzjonijiet