Skip to main content
Solved

Error when Importing API Swagger

  • February 14, 2025
  • 5 replies
  • 105 views

Stijn Verhoeff
Starter

We are using the new 'Import Swagger/OpenAPI’ feature in the TX REST Data Source (absolutely loving that btw), but are encountering an error. 

 

When importing the URL for a Weather API, we receive the following error message:

Error: Exception Type: Microsoft.OpenApi.Readers.Exceptions.OpenApiUnsupportedSpecVersionException Message: OpenAPI specification version '3.1.0' is not supported.

 

So far we've had no trouble importing Open API spec 3.0.0 documentation. Is there a compatibility issue with the latest 3.1.0 spec?

Best answer by Thomas Lind

Hi ​@Stijn Verhoeff 

I got a response.

We use OpenAPI.net to read and parse the swagger. The current version does not support version 3.1.0, but there is a preview version that supports it. 
https://github.com/microsoft/OpenAPI.NET/issues/795
They are currently on preview 7. 

 

They will work on this for a future release. The decision to be made is whether to wait for a full release instead of getting it to work with the preview release.

For now there doesn’t seem like a workaround for this, I could not find a way to make it use version 3.0.0.

View original
Did this topic help you find an answer to your question?

Thomas Lind
Community Manager
Forum|alt.badge.img+5
  • Community Manager
  • 1057 replies
  • February 17, 2025

Hi ​@Stijn Verhoeff 

I will try to figure this out.


Thomas Lind
Community Manager
Forum|alt.badge.img+5
  • Community Manager
  • February 17, 2025

Hi ​@Stijn Verhoeff 

I got a response.

We use OpenAPI.net to read and parse the swagger. The current version does not support version 3.1.0, but there is a preview version that supports it. 
https://github.com/microsoft/OpenAPI.NET/issues/795
They are currently on preview 7. 

 

They will work on this for a future release. The decision to be made is whether to wait for a full release instead of getting it to work with the preview release.

For now there doesn’t seem like a workaround for this, I could not find a way to make it use version 3.0.0.


Stijn Verhoeff
Starter

Hi ​@Thomas Lind

Thanks for the quick response! That in itself is already an answer; we'll pursue other sources first while awaiting this release. Seeing as there is already a preview 8 by now, there does seem to be active development from their side. Do what you think is wise; we’re eager to use it whenever it becomes available! 

It might be useful for others to list this as a compatibility issue on the REST Data Source's documentation page. With how valuable this feature has been already, I expect others will soon run into the same issue. 


Stijn Verhoeff
Starter

Hi ​@Thomas Lind

 

The latest TimeXtender Tuesday video on YouTube features this exact API and seems to work perfectly. However, when I try to import the JSON myself (TDI 6935.1, REST 9.0.0.0), I still get the OpenAPI 3.1.0 spec error:

Error: Exception Type: Microsoft.OpenApi.Readers.Exceptions.OpenApiUnsupportedSpecVersionException Message: OpenAPI specification version '3.1.0' is not supported.

 

Is there a product update I missed somehow, or is the build used in that video not publicly available yet? The latter case might not be so convenient for anyone trying to follow along with the tutorial. 


Thomas Lind
Community Manager
Forum|alt.badge.img+5
  • Community Manager
  • 1057 replies
  • April 10, 2025

Hi ​@Stijn Verhoeff 

I talked with the person who were hosting the video.

This support case was actually my inspiration for the video as the site had everything I needed, but I also ran into the same issue.

I used a little "Hollywood magic" for the video and converted the Swagger to v3.0 using APIMatic (free conversion service).

 

Import the content of the file as a JSON import or try out the converter yourself.


Reply


Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings