Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cineálacha Tacaíochta agus Scéimí JSON

Ceacht 2 as 12 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Bunghnéithe do chuid scéimí
  2. Na seacht gcineál a dtacaítear leo
  3. Cineálacha a chomhcheangal
  4. Réimsí roghnacha
  5. Príomhphointí

Bunghnéithe do chuid scéimí

Chun struchtúr do chuid freagraí a shainiú, tá seacht gcineál JSON ar fáil duit. Freastalaíonn gach ceann acu ar riachtanas sonrach i samhaltú do chuid sonraí. Tá sé ríthábhachtach na cineálacha seo a thuiscint chun scéimí éifeachtacha a dhearadh.

Na seacht gcineál a dtacaítear leo

string

An cineál is coitianta. Úsáidtear é d’ainmneacha, tuairiscí, aitheantóirí, agus d’aon ábhar téacs.

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "description": { "type": "string" }
  }
}

number

Clúdaíonn sé slánuimhreacha agus snámhphointí. Níl aon idirdhealú idir integer agus float – láimhseálann cineál amháin number an dá cheann.

{
  "properties": {
    "price": { "type": "number" },
    "quantity": { "type": "number" }
  }
}

boolean

Fíor nó bréagach. Foirfe do bhratacha, bailíochtuithe, agus cinntí dénártha.

{
  "properties": {
    "in_stock": { "type": "boolean" },
    "express_delivery": { "type": "boolean" }
  }
}

object

Ligeann sé duit struchtúir a neadú. Is féidir le hoibiacht oibiachtaí eile, eagarraí, nó scálairí a bheith inti – gan aon teorainn doimhneachta.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "street": { "type": "string" },
        "city": { "type": "string" },
        "postal_code": { "type": "string" }
      }
    }
  }
}

array

Liostaí d’eilimintí den chineál céanna. Is féidir leat eagarraí de shreanga, uimhreacha, oibiachtaí, nó fiú eagarraí eile a bheith agat.

{
  "properties": {
    "skills": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

enum

Tacar críochta de luachanna ceadaithe. Riachtanach do chatagóiriú agus d’aicmiú.

{
  "properties": {
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    }
  }
}

anyOf

Ligeann sé duit aontais chineáil a shainiú. Is féidir le réimse roinnt struchtúr éagsúil a ghlacadh. Úsáideach nuair is féidir le réimse amháin foirmeacha éagsúla a ghlacadh.

{
  "properties": {
    "contact": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "email": { "type": "string" }
          }
        },
        {
          "type": "object",
          "properties": {
            "phone": { "type": "string" }
          }
        }
      ]
    }
  }
}

Cineálacha a chomhcheangal

Tagann cumhacht na scéimí ó na cineálacha seo a chomhcheangal. Seo scéim réadúil chun táirge a anailísiú:

{
  "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" }
      }
    }
  }
}

Meascann an scéim seo scálairí, enum, eagar, agus oibiacht neadaithe. Urramóidh an tsamhail gach srian ar gach glao.

Réimsí roghnacha

Chun réimse a dhéanamh roghnach, úsáid anyOf le null:

{
  "properties": {
    "phone": {
      "anyOf": [
        { "type": "string" },
        { "type": "null" }
      ]
    }
  }
}

I bPydantic, freagraíonn sé seo do phone: str | None.

Príomhphointí

  • Seacht gcineál ar fáil: string, number, object, array, boolean, enum, anyOf
  • Comhcheanglaítear cineálacha go saor chun struchtúir chasta a shamhaltú
  • Úsáideann réimsí roghnacha anyOf le null
  • Gan idirdhealú idir slánuimhir/snámhphointe – cineál amháin number
  • Cuirtear luachanna réamhshainithe i bhfeidhm le enum d’aicmithe