title: Open Api documentation for a single endpoint multiple posts request
body: <p>I am trying to have Swagger/Open Api documentation for my single endpoint API.</p>
  
  <p>My single endpoint looks like </p>
  
  <blockquote>
    <p>POST: <a href="http://localhost/api/v1/process" rel="nofollow noreferrer">http://localhost/api/v1/process</a></p>
  </blockquote>
  
  <p>the post body determines the logical path and response schema</p>
  
  <p><code>Body1: {"jsonClass": "AnimalsRankedByLifeSpan"}
  Response1: schema-1</code></p>
  
  <p><code>Body2: {"jsonClass": "AnimalsInRegion", "region":"Africa", "type":"lions"}
  Response2: schema-2</code></p>
  
  <p>Expectation from documentation: Each jsonClass is listed as a separate call in swagger (or any other) and I can use the spec to get all the jsonClasses supported.</p>
  
  <p>Doesnt look like, swagger supports this kind of design. If it does, please point me to examples.</p>
  
  <p>Are there any other Api documentation frameworks I can use for providing request-response documentation for each kind of jsonClass supported?</p>