Generate OpenAPI definition for a Proxy in API Management

[mpineyro]

I developed and published an API Proxy in API Portal. The API Proxy works Ok and I am invoking it from an iflow through an Open Connector adapter. Now I need to map values from an incoming message into the values of the body of my API Proxy and I am trying to use de message mapping block for this purpose. Whenever I try to upload a JSON definition created from a request sample I get an error (invalid file).

Considering that the mapping block accepts OpenAPI definitions, does anyone know if it's possible to download from API Portal the definition of an API Proxy in OpenAPI format?

Thanks

[Willem_Pardaens]

Hi Martin,

On the condition that your API Proxy has resources defined (entities and their properties), you can download its OpenAPI specifications easily. Just click on 'Edit' > 'Edit in API Designer' > 'Download'.

Thanks,
Willem

[mpineyro]

Willem, thanks for your answer.

My API Proxy has resources defined and I am able to download the specifications in JSON o YAML format as shown in the image. The problem is that when I try to upload it to map object I get an error message saying that the "file has validation errors".

It seems that the downloaded file does does not follow the OpenAPI Specification, and I don't know how I can generate an OpenAPI compliant version of the specification.

[Willem_Pardaens]

Hi Martin, maybe try pasting your OpenAPI specification into the public Swagger editor: https://editor.swagger.io/, maybe this one highlights what is wrong with it and how to fix it?