Skip to Content
1

Using Swagger/OpenAPI to describe and discover SAP Gateway/OData API?

Oct 17, 2016 at 07:15 PM

933

avatar image

Currently, the only way to get information from an API developed with the Gateway Builder is using the OData $metadata parameter. Another popular option for describing and discovering a RESTful service is Swagger, now part of the Open API initiative (of which Microsoft is a member, but looks like SAP is not (yet)).

I saw on the OASIS standards committee web page that Swagger will be an alternative to describe OData metadata in JSON format: https://issues.oasis-open.org/browse/ODATA-907

When will SAP support this?

BTW, I found a node module that can be used to convert an existing OData metadata to the Open API format: https://www.npmjs.com/package/odata2openapi

- Guy

10 |10000 characters needed characters left characters exceeded
* Please Login or Register to Answer, Follow or Comment.

1 Answer

Holger Bruchelt Dec 01, 2016 at 10:12 AM
0

Hi Guy,

we are actually working right now on the SAP API Designer (as part of the API Management). As part of this designer (based on the Swagger Editor) we have implemented a feature to convert your $metadata into a OpenAPI format.

Feel free to check out the API Designer from your HCP Trial instance -> Services -> API Management (you might need to activate SAP API management first, Free Trial of SAP API Management on HANA Cloud Platform is available now!)

Hope this helps,

Holger.


apidesigner.jpg (32.2 kB)
pasteodata.png (27.4 kB)
Share
10 |10000 characters needed characters left characters exceeded