Sprawdzanie poprawności JSON względem schematu interfejsu Swagger API

Question

Utworzono specyfikację interfejsu API z niektórych plików JSON i próbuję sprawdzić, czy pliki sprawdzają się pod kątem specyfikacji interfejsu API.

Istnieje kilka dobrych narzędzi do sprawdzania poprawności w stosunku do schematu JSON, ale nie miałem okazji znaleźć narzędzia do sprawdzenia poprawności względem specyfikacji utworzonych w narzędziu Swagger (narzędzie do tworzenia schematu interfejsu API). Jedynym znalezionym rozwiązaniem jest generowanie klienta/serwera w edytorze Swagger-Editor, jest to dość kłopotliwe.

Czy istnieje już narzędzie do sprawdzania poprawności JSON przeciwko schematowi Swagger?

Answer 1

Jeśli Swagger JSON jest obsługiwany, można użyć następującego adresu URL: http://online.swagger.io/validator/debug?url=your_url

Answer 2

Arnaud w komentarzach jest prawdą, że istnieją dwa odrębne pytania tutaj.

Chcesz, aby potwierdzić, że specyfikacja jest ważna OpenAPI (FKA. Swagger) wg planu

Można

• Skopiuj specyfikację do online Swagger editor i będzie rzucać błędów. Szybkie przechodzenie przez source nie mówi mi, czego używa do tworzenia tych błędów, ale nie wydaje się, aby kontaktował się z serwerem, aby to zrobić ...
• Skorzystaj z oficjalnej wersji swagger-parser dla języka Java.
• Użyj nieoficjalnego swagger-parser dla JavaScript (przeglądarki lub węzła).

lub potwierdzenie, że realizacja tej specyfikacji będzie produkować JSON, który jest ważny w odniesieniu swoimi schematami JSON?

Innymi słowy, oto trochę JSON z żądania lub treści odpowiedzi, czy to prawda?

Swagger opiera się na innym standardzie o nazwie Schemat JSON dla jego schema objects, który jest tym, co faktycznie opisuje JSON (zamiast punktów końcowych lub metadanych). Swagger używa podzestawu schematu JSON (brakuje między innymi: oneOf, patternProperties). W tym celu można użyć walidatora schematu JSON. Istnieje 37 listed here; Dam ci głos do this online validator, który obsługuje również schematy YAML.

Ale kiedy powiedziałem, że Swagger opiera się na podzbiorze JSON API, skłamałem. Istnieje kilka stałych pól, które mają specjalne znaczenie w Swaggerze, które nie są częścią schematu JSON. Jednym z nich jest discriminator, który jest używany do polimorfizmu. Nie jestem świadomy walidatora Swagger, który może przetworzyć discriminator. Istnieje atrybut fair number of tools dla osoby przechwalającej się i niektórzy twierdzą, że dokonują sprawdzania poprawności, ale wiele z nich to abandonware, przeznaczone dla starszych wersji, nieobsługujące funkcji, powiązane z innymi technologiami i tak dalej. Jeśli istnieje dojrzała i dobrze utrzymana biblioteka, której mi brakuje, chciałbym to wiedzieć.