Apigee2OpenAPI Core dump

[#1]

Hi,

I have apigee2openapi installed on my ubuntu machine. My npm is crashing while exporting api proxy as openapi file. I have some Java jar files , Java and Javascript policies in my APIproxy and I am getting following error while generating openapi file;

Ubuntu cmdline output

coredump.txt

[#2]

Hi Devs,

I have another revision of this API proxy that doesn't contain JAR files and Java policy. For that API proxy JSON file is generated fine without any error message but generated swagger file have one operation missing (PUT call) and and doesn't contain any definitions for successful responses or error codes likes 500, 404 and failed repsonses etc. So even this generated swagger document barely contains any significant information . I don't understand why was this plugin created in first place or am I using it wrong ?

I find that this tool is better -> http://specgen.apistudio.io as swagger generated by this has more information but again how it can be used to generated and document all possible responses 2xx, 4xx,5xx as at any time it seems to generate only one request (GET/PUT/DEL etc) and one response (2xx/4xx/5xx etc) and create swagger document based on that ?

Proxy ExportSize with Jar files -> 2.5Mb

Proxy ExportSize without Jar files and JavapoLicy -> 20Kb

[anilsr · Accepted solution]

@Mayank , Apigee2OpenAPI generates minimal OpenAPI spec due to the fact that API Proxy doesn't contain API runtime information. As you said, http://specgen.apistudio.io is much better tool. Apigee2OpenAPI is created as a community open source project long before http://specgen.apistudio.io . Glad you found above tools useful.

http://specgen.apistudio.io supports multiple API resources, you just need to start over again from home page. I haven't tested multiple response code within same API resource. Great feedback, will let you know if any updates in that direction. Remember, Above projects are not officially supported by Apigee, They are labs projects & supported only through community. Hope it helps.

[#4]

So other than generating swagger using third party tool and importing swagger doc in Smartdocs model, Is there any way we can automatically generate swagger document in developer portal for an api ?

[anilsr]

@Mayank , See this article here which helps to use APIs to render smartdocs in portal. If your original question above is answered, please feel free to accept above answer.

[#6]

Hi Anil, Thanks for this link, but even with the steps mentioned in this link, a pre built swagger/YAML document is used to create and render api model smart docs. Is there any way, we can accomplish this with API proxies without using swagger doc ?