Does Swagger doc generated from TIBCO BW 5.13(5.x) REST service can be converted as IO Doc in TIBCO Mashery

[venky b]

Hi,

i have generated swagger doc using tibco BW 5.13 and i want to use same swagger doc to be exposed on TIBCO Mashery. even though Mashery has provided tool to convert swagger doc to IO doc but the swagger which i generated with bw 5.13 is not working. can anyone suggests what needs to be done

[Andy-dont-use Pritchard]

Chityluv .... I thought BW 5 produces Swagger 1.0 format documents. Can you check the header for the version

The field developed Mashery Tools project only supports Swagger 2.0. If it says it's 2.0 can you send me the swagger definition to look at

 

Andy

[venky b]

Hi Andy,

 

 

 

yes BW 5 producing Swagger 1.2 version. here is the sample swagger doc generated from BW 5.13. Could you please let me know is there any work around to solve this issue

 

 

 

{"apis":[{"operations":[{"consumes":["application/json"],"produces":["application/json"],"responseMessages":[{"code":"200","message":""}],"parameters":[{"name":"ReqID","paramType":"header","required":true,"type":"string","allowMultiple":false},{"name":"StreetName","paramType":"query","required":true,"type":"string","allowMultiple":false},{"name":"CityName","paramType":"query","required":true,"type":"string","allowMultiple":false},{"name":"ZipCode","paramType":"query","required":true,"type":"string","allowMultiple":false},{"name":"body","paramType":"body","required":false,"type":"string","allowMultiple":false}],"nickname":"Method1","method":"POST","summary":"","notes":"","type":"string","authorizations":[]}],"path":"/TestResource"}],"apiVersion":"1.0","swaggerVersion":"1.2","basePath":"http://localhost:9094","resourcePath":"/TestResource"}

[Andy-dont-use Pritchard]

Probably the best option is to convert it to swagger 2.0. There are various tools out there that you can run locally to migrate and you might want to look at APIMatic (but i think it's not free anymore).

[venky b]

I guess that's the best option to solve this issue.

 

Thanks Andy, Apperciate your help.

[William Cheng]

Another option it to use https://editor.swagger.io to convert the spec into Swagger/OpenAPI 2.0 format as part of the import process (File => Import File)

 

You can also try other free, open source tools such as https://github.com/lucybot/api-spec-converter to perform the conversion.

[SUSANT KUMAR PALAI]

Hi Venkat,

 

How did you convert your TIBCO project , having REST API, to Swagger 2.0 format

 

I am am working on Tibco version 5.14  .

 

 

 

Regards

 

Susant