Cineálacha Tacaíochta agus Scéimí JSON
Ar an leathanach seo
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
anyOflenull - Gan idirdhealú idir slánuimhir/snámhphointe – cineál amháin
number - Cuirtear luachanna réamhshainithe i bhfeidhm le
enumd’aicmithe