Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Ondersteunde typen en JSON-schema's

Les 2 van 12 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. De bouwstenen van uw schema’s
  2. De zeven ondersteunde typen
  3. Typen combineren
  4. Optionele velden
  5. Belangrijkste punten

De bouwstenen van uw schema’s

Om de structuur van uw antwoorden te definiëren, heeft u zeven JSON-typen tot uw beschikking. Elk type vervult een specifieke behoefte bij het modelleren van uw gegevens. Inzicht in deze typen is essentieel voor het ontwerpen van effectieve schema’s.

De zeven ondersteunde typen

string

Het meest voorkomende type. Gebruikt voor namen, beschrijvingen, identificatiecodes en alle tekstinhoud.

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

number

Dekt zowel gehele getallen als kommagetallen. Er is geen onderscheid tussen integer en float; één enkel type number behandelt beide.

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

boolean

Waar of onwaar. Ideaal voor vlaggen, validaties en binaire beslissingen.

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

object

Stelt u in staat structuren te nesten. Een object kan andere objecten, arrays of scalairen bevatten, zonder dieptelimiet.

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

array

Lijsten met elementen van hetzelfde type. U kunt arrays van strings, getallen, objecten of zelfs arrays hebben.

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

enum

Een eindige reeks toegestane waarden. Essentieel voor categorisaties en classificaties.

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

anyOf

Hiermee definieert u type-unies. Een veld kan meerdere verschillende structuren accepteren. Handig wanneer één veld gevarieerde vormen kan aannemen.

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

Typen combineren

De kracht van schema’s zit in het combineren van deze typen. Hieronder ziet u een realistisch schema om een product te analyseren:

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

Dit schema combineert scalairen, een enum, een array en een genest object. Het model zal bij elke aanroep elke beperking respecteren.

Optionele velden

Gebruik anyOf met null om een veld optioneel te maken:

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

In Pydantic komt dit overeen met phone: str | None.

Belangrijkste punten

  • Zeven beschikbare typen: string, number, object, array, boolean, enum, anyOf
  • Typen kunnen vrij worden gecombineerd om complexe structuren te modelleren
  • Optionele velden gebruiken anyOf met null
  • Geen onderscheid tussen geheel getal/kommagetal; één enkel type number
  • enum forceert vooraf gedefinieerde waarden voor classificaties