Forum Discussion

Dharma_Teja's avatar
Dharma_Teja
Occasional Visitor
4 years ago

how we can document for the same api which is having two diffrent ussage .

Hi SwaggerHub team,   i have an api to login, i am using same api to get login using OTP .            same api i am using to get login using MPIN by changing parameters with same URL. when i crea...
TanyaYatskovska's avatar
TanyaYatskovska
SmartBear Alumni (Retired)
4 years ago

Hi Dharma_Teja,

 

If you are using OpenAPI 3.x, you can look at using oneOf. Here is an example:

paths:
  /login:
    post:
      #...
      responses:
        201:
          application/json:
            content:
              schema:
                oneOf:
                - '#/components/schemas/one'
                - '#/components/schemas/two'

If this doesn't help, could you please share the entire definitions?