Generator JSON Schema 2020-12 z próbki JSON
Wklej przykładowy JSON i utwórz schemat struktury danych.
Przejdź do narzędziaWklej przykładowy JSON i utwórz schemat struktury danych. Możesz uwzględnić kilka rekordów, poprawić typy i wymagane pola oraz sprawdzić zmienione reguły.
Spis treści
Wynik i eksport
Brak gotowego wyniku
Możesz edytować kod: np. type lub required. Po zmianie sprawdź schemat przed eksportem.
Uzupełnij formularz i utwórz wynik.
Jak działa narzędzie
- Wklej JSON albo użyj przykładu. Wybierz pojedynczy dokument lub tablicę niezależnych próbek.
- Określ wymagane pola: obecne we wszystkich próbkach, wszystkie zaobserwowane lub żadne.
- Opcjonalnie zamknij obiekty dla dodatkowych pól i wpisz tytuł.
- Utwórz schemat. W edytorze możesz zmienić type, required i inne obsługiwane reguły.
- Po edycji kliknij „Sprawdź schemat i próbki”. Przeczytaj różnice, a następnie pobierz wynik.
Szczegóły techniczne
Wynik deklaruje draft 2020-12. Generator grupuje zaobserwowane wartości według typów. Wartości całkowite i dziesiętne wspólnie dają number, a odmienne rodzaje danych są łączone przez anyOf. W obiektach zbiera nazwy właściwości; domyślnie wymaga tylko tych, które występują w każdej próbce danego obiektu. Z elementów tablic wyprowadza wspólny schemat items. Pusta tablica nie ujawnia typu elementów, dlatego items pozostaje otwarte.
Tryb pojedynczego dokumentu traktuje tablicę jako tablicę w schemacie. Tryb wielu próbek traktuje jej elementy jako osobne przykłady tego samego dokumentu. To istotna różnica przy opisywaniu jednego rekordu API i całej listy rekordów.
FAQ
Czy wynik jest zgodny z JSON Schema?
Wygenerowane konstrukcje używają draftu 2020-12. Wersja znajduje się w $schema. Reguły wynikają tylko z dostarczonych przykładów i wybranych ustawień.
Jak zmienić wymagane pola?
W ustawieniach wybierz sposób wnioskowania required albo po wygenerowaniu edytuj tablicę required bezpośrednio w kodzie. Następnie sprawdź schemat.
Czy to zastępuje pełny walidator JSON Schema?
Wbudowane sprawdzanie obejmuje wymieniony podzbiór używany przez generator. Schematy z innymi słowami kluczowymi sprawdź narzędziem obsługującym pełny draft 2020-12.
Ograniczenia narzędzia
Próbki nie ustalają wszystkich dozwolonych wartości. Generator nie zgaduje enum, wyrażeń regularnych, formatów dat ani reguł biznesowych. Nie jest generatorem danych strukturalnych Schema.org do SEO. Służy do opisania i sprawdzania struktury JSON. Zmiana type lub required może celowo sprawić, że początkowa próbka przestanie być zgodna; taki schemat nadal można pobrać po sprawdzeniu jego struktury.
Edytor sprawdza obsługiwany podzbiór: $schema, title, description, type, properties, required, additionalProperties, items, anyOf, enum, minimum, maximum, minLength, maxLength, minItems, maxItems oraz schematy true/false. Inne słowa, w tym $ref, format i pattern, wymagają zewnętrznego walidatora. Zewnętrzne schematy nie są pobierane. Limit wejścia to 500 000 znaków, 24 poziomy i 50 000 wartości. Powtórzone klucze i liczby całkowite poza bezpiecznym zakresem JavaScript są odrzucane; duży identyfikator zapisz jako tekst.
Źródła i aktualizacja
- JSON Schema — draft 2020-12 — sprawdzono 18.09.2026.
- JSON Schema — słowa walidacyjne — sprawdzono 18.09.2026.