You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If no examples are specified for an API endpoint, then an example is generated from the schema. For request payloads, this is populated into the request field.
But if examples are specified in the OpenAPI spec, then these generated examples are omitted. I actually find the generated examples useful since they show all fields and it is easy to craft any kind of request payload starting from that. And the explicit examples are obviously useful because they show specific use cases.
It would be good if there was an option to include both the explicit and generated examples.
The text was updated successfully, but these errors were encountered:
If no examples are specified for an API endpoint, then an example is generated from the schema. For request payloads, this is populated into the request field.
But if examples are specified in the OpenAPI spec, then these generated examples are omitted. I actually find the generated examples useful since they show all fields and it is easy to craft any kind of request payload starting from that. And the explicit examples are obviously useful because they show specific use cases.
It would be good if there was an option to include both the explicit and generated examples.
The text was updated successfully, but these errors were encountered: