Tipuri suportate și scheme JSON
Pe această pagină
Blocurile de construcție ale schemelor dumneavoastră
Pentru a defini structura răspunsurilor dumneavoastră, aveți la dispoziție șapte tipuri JSON. Fiecare servește unei nevoi specifice în modelarea datelor. Înțelegerea acestor tipuri este esențială pentru proiectarea unor scheme eficiente.
Cele șapte tipuri suportate
string
Cel mai comun tip. Se utilizează pentru nume, descrieri, identificatori și orice conținut textual.
{
"type": "object",
"properties": {
"name": { "type": "string" },
"description": { "type": "string" }
}
}
number
Acoperă atât numerele întregi, cât și pe cele cu virgulă flotantă. Nu există nicio distincție între integer și float — un singur tip number le gestionează pe ambele.
{
"properties": {
"price": { "type": "number" },
"quantity": { "type": "number" }
}
}
boolean
Adevărat sau fals. Ideal pentru indicatori (flags), validări și decizii binare.
{
"properties": {
"in_stock": { "type": "boolean" },
"express_delivery": { "type": "boolean" }
}
}
object
Vă permite imbricarea structurilor. Un obiect poate conține alte obiecte, tablouri (arrays) sau scalari — fără nicio limită de adâncime.
{
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"street": { "type": "string" },
"city": { "type": "string" },
"postal_code": { "type": "string" }
}
}
}
}
array
Liste de elemente de același tip. Puteți avea tablouri de șiruri, numere, obiecte sau chiar alte tablouri.
{
"properties": {
"skills": {
"type": "array",
"items": { "type": "string" }
}
}
}
enum
Un set finit de valori permise. Esențial pentru categorizări și clasificări.
{
"properties": {
"priority": {
"type": "string",
"enum": ["low", "medium", "high", "critical"]
}
}
}
anyOf
Vă permite definirea uniunilor de tipuri. Un câmp poate accepta mai multe structuri diferite. Util atunci când un singur câmp poate lua forme variate.
{
"properties": {
"contact": {
"anyOf": [
{
"type": "object",
"properties": {
"email": { "type": "string" }
}
},
{
"type": "object",
"properties": {
"phone": { "type": "string" }
}
}
]
}
}
}
Combinarea tipurilor
Puterea schemelor provine din combinarea acestor tipuri. Iată o schemă realistă pentru analizarea unui produs:
{
"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" }
}
}
}
}
Această schemă combină scalari, un enum, un tablou și un obiect imbricat. Modelul va respecta fiecare constrângere la fiecare apel.
Câmpuri opționale
Pentru a face un câmp opțional, utilizați anyOf împreună cu null:
{
"properties": {
"phone": {
"anyOf": [
{ "type": "string" },
{ "type": "null" }
]
}
}
}
În Pydantic, acest lucru corespunde lui phone: str | None.
Puncte cheie
- Șapte tipuri disponibile:
string,number,object,array,boolean,enum,anyOf - Tipurile se combină liber pentru a modela structuri complexe
- Câmpurile opționale utilizează
anyOfcunull - Nicio distincție între întreg și flotant — un singur tip
number enumimpune valori predefinite pentru clasificări