Salt la conținutul principal
Română— Alege o limbă
Meniu

Tipuri suportate și scheme JSON

Lecția 2 din 12 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Blocurile de construcție ale schemelor dumneavoastră
  2. Cele șapte tipuri suportate
  3. Combinarea tipurilor
  4. Câmpuri opționale
  5. Puncte cheie

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ă anyOf cu null
  • Nicio distincție între întreg și flotant — un singur tip number
  • enum impune valori predefinite pentru clasificări