Visualization of the content

[karelhusa]

I would propose to add some API visualization, of some real API in Swagger-ui, Redoc or Postman.

E.g., in the Postman screenshots, we can easily show the process:

• here's my request
• this is the API operation
• here came the response

All these API parts are described in OpenAPI.

We can have a list of things described by OpenAPI:

• operations
• requests (body and params)
• responses
• error responses
• security
• examples
• etc.

At the end we come to the conclusion, that OpenAPI contains everything people or computers need to know about the API.