Forum Discussion

sandycs's avatar
sandycs
New Contributor
5 years ago

SwaggerHub Domain object to JSON schema

Hi , Is there a feature to convert Swagger Hub domain object to JSON Schema? or is this a manual process? And also which version of draft json schema is supported by open api 3.0.0?   Thanks,...
HKosova's avatar
HKosova
SmartBear Alumni (Retired)
5 years ago

Hi Sandy,

 

OpenAPI 3.0 uses an extended subset of JSON Schema Wright Draft 00 aka Draft 5.

 

SwaggerHub does not have a way to convert Domains to JSON Schemas. However, third-party OpenAPI-to-JSON Schema converters exist that might be able to do that.

  • sandycs's avatar
    sandycs
    New Contributor
    5 years ago
    Thanks Helen. That’s useful info. Having done bit of reading json schema draft 8 is the latest and apparently there has been lot of deviations from draft 5 . Not ideal when we look to standardise and design interoperable APIs .
    • HKosova's avatar
      HKosova
      SmartBear Alumni (Retired)
      5 years ago

      Hi Sandy,

       

      It is likely that OpenAPI version 3.1 (next minor update) will adopt the latest JSON Schema draft 2019-09. You can track this PR in the OpenAPI Specification repository for details:

      https://github.com/OAI/OpenAPI-Specification/pull/1977