Ondersteunde typen en JSON-schema's
Op deze pagina
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
anyOfmetnull - Geen onderscheid tussen geheel getal/kommagetal; één enkel type
number enumforceert vooraf gedefinieerde waarden voor classificaties