Generator schematów JSON

Co wnioskowanie robi dobrze

• Typy: string, number, integer, boolean, null, array, object.
• Możliwość wartości null: pole, które w jednej próbce ma wartość null, a w innej jest ciągiem znaków, staje się ["string", "null"].
• Elementy tablicy: tablice jednorodne tworzą pojedynczy schemat items; tablice niejednorodne tworzą prefixItems.
• Wyliczenia (enum): jeśli wszystkie zaobserwowane wartości pochodzą z małego zbioru (konfigurowalne, domyślnie 10 różnych wartości), generowany jest enum.
• Wymagane: przy wielu próbkach część wspólna kluczy staje się required; przy jednej próbce wszystkie klucze są wymagane, chyba że z tego zrezygnujesz.
• Formaty: ciągi zgodne z datami ISO-8601, adresami e-mail lub URI otrzymują wywnioskowany format.

Czego wnioskowanie nie może wiedzieć

• Zamiar a przykład: próbka age: 25 wnioskuje type: integer, ale nie może wiedzieć, że akceptujesz również null. Podaj kilka próbek obejmujących przypadki brzegowe.
• Ograniczenia: minLength, maximum, pattern, musisz dodać je ręcznie. Wnioskowanie nie zgaduje granic na podstawie próbek.
• Logika biznesowa: warunek “dokładnie jedno z tych trzech pól musi być ustawione” wymaga oneOf, nie da się go wywnioskować.
• Referencje: generator tworzy płaski schemat. Jeśli chcesz wydzielić powtarzające się struktury do $defs, zrób to po wygenerowaniu.

Przykładowe wyjście

Z pojedynczej próbki:

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

Wywnioskowany schemat (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"]
}

Najczęstsze błędy

• Wnioskowanie z jednej próbki. Schemat będzie przeuczony, każde pole staje się wymagane, bez tolerancji dla null. Zawsze podawaj co najmniej 5–10 różnorodnych próbek.
• Użycie integer, gdy chodziło o number. Jeśli którakolwiek próbka zawiera liczbę dziesiętną, wywnioskowany typ staje się number; jeśli wszystkie są całkowite, staje się integer. Dla pól, które mogą być jednym lub drugim, dołącz próbkę z liczbą dziesiętną.
• Pominięcie pól opcjonalnych. Pole obecne w 4 z 5 próbek, ale brakujące w 1, staje się opcjonalne, zgodnie z zamierzeniem. Jeśli wszystkie 5 próbek przypadkiem je zawiera, schemat oznaczy je jako wymagane, mimo że w Twoim API jest ono w rzeczywistości opcjonalne.