Mock/sample requests and responses payload in the developer portal
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?
Answer by Dino-at-Google
·
May 21, 2020 at 04:18 PM
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.
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.
