API Connect

IBM API Connect Open API 3.0 Editor support on UI 

Mon December 14, 2020 01:41 AM


0 Favorited
1 Files


Mon December 14, 2020 01:04 PM

Hi Praveen,
Thanks for the feedback.
The documentation has been referenced in the Blog post where this demo has been added - https://community.ibm.com/community/user/middleware/blogs/swetha-sridharan1/2020/12/14/openapi3-editor
Documentation also talks about what's the limitation around having more than one server because of what API GW currently supports - https://www.ibm.com/support/knowledgecenter/SSMNED_v10/com.ibm.apic.toolkit.doc/rapic_oai3_support.html

Mon December 14, 2020 04:22 AM

Hi Swetha,

It would have been useful to talk to OAI v3 support in v10 documentation in  the demo (https://www.ibm.com/support/knowledgecenter/SSMNED_v10/com.ibm.apic.toolkit.doc/rapic_oai3_support.html). The documentation seems to differ with the product features in some respects like the 'servers' property allowing more than one server to be added whereas the documentation states that the servers array can not contain more than one server.

An important point to note is that the servers property in OAI v3 schema does not have a 'type' field so one can not specify a url as 'development' or 'production' or 'internal-cloud'. However, this can be achieved by using 'x-ibm-endpoints' property.

Thanks for the good sneak peek.