Mock/sample requests and responses payload in the developer portal

[neerajmehta]

What are the options to display sample requests and responses payload in the developer portal? I am aware of these options: create a mock response with no-target, javascript policy, and node.js integration if API is in development. Is there any configuration within the dev portal which generates sample requests/responses and returns a real response in case of customer data. We can achieve this with the sandbox env, what are the other options?

[dchiesa1]

if the OpenAPI Spec includes example requests and responses, the documentation for an API will render those examples.

Currently, it does not combine individual property examples in a schema into a combined schema example. We hope to add that at some point.

Today, the spec author could still write the full schema example on their own - it is just not automatically generated.

[neerajmehta]

Can you please any sample OpenAPI spec to try? maybe openapi spec of Mocktarget_Apigee with examples of request/response. I tried one from petstore swagger YAML file, it's not working as expected.