JSON-schemagenerator

Wat de inferentie goed doet

• Typen: string, number, integer, boolean, null, array, object.
• Nullbaarheid: een veld dat in het ene voorbeeld null is en in het andere een string, wordt ["string", "null"].
• Array-elementen: homogene arrays leveren één items-schema op; heterogene arrays leveren prefixItems op.
• Opsommingen (enum): als alle waargenomen waarden uit een kleine verzameling komen (instelbaar, standaard 10 verschillende waarden), wordt een enum uitgevoerd.
• Verplicht: bij meerdere voorbeelden wordt de doorsnede van sleutels required; bij één voorbeeld zijn alle sleutels verplicht, tenzij u zich afmeldt.
• Formaten: strings die overeenkomen met ISO-8601-datums, e-mailadressen of URI’s krijgen een afgeleid format.

Wat de inferentie niet kan weten

• Bedoeling versus voorbeeld: een voorbeeld age: 25 leidt type: integer af, maar kan niet weten dat u ook null accepteert. Geef meerdere voorbeelden die randgevallen dekken.
• Beperkingen: minLength, maximum, pattern, deze moet u handmatig toevoegen. De inferentie raadt geen grenzen op basis van voorbeelden.
• Bedrijfslogica: “precies één van deze drie velden moet ingesteld zijn” vereist oneOf, niet af te leiden.
• Referenties: de generator levert een plat schema op. Als u herhaalde vormen wilt uitsplitsen naar $defs, doe dat dan na het genereren.

Voorbeelduitvoer

Uit één voorbeeld:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

Het afgeleide schema (draft 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Veelvoorkomende fouten

• Afleiden uit één voorbeeld. Het schema wordt overfit: elk veld wordt verplicht, zonder tolerantie voor null. Geef altijd minstens 5–10 gevarieerde voorbeelden.
• integer gebruiken terwijl u number bedoelde. Als een voorbeeld een decimaal bevat, wordt het afgeleide type number; als alle waarden gehele getallen zijn, wordt het integer. Neem voor velden die beide kunnen zijn een voorbeeld met een decimaal op.
• Optionele velden vergeten. Een veld dat in 4 van de 5 voorbeelden voorkomt maar in 1 ontbreekt, wordt optioneel, zoals bedoeld. Als alle 5 voorbeelden het toevallig bevatten, markeert het schema het als verplicht, ook al is het in uw API eigenlijk optioneel.