Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tipi Appoġġjati u Skemi JSON

Lezzjoni 2 / 12 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Il-blokki tal-bini tal-iskemi tiegħek
  2. Is-seba’ tipi appoġġjati
  3. Il-kombinazzjoni tat-tipi
  4. Kampijiet fakultattivi
  5. Punti Ewlenin

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 anyOf ma’ null
  • L-ebda distinzjoni bejn integer/float — tip wieħed number
  • enum jinfurza valuri predefiniti għall-klassifikazzjonijiet