Forum Discussion

belgi's avatar
belgi
New Contributor
6 years ago

Swagger json format that works for codegen and redoc

I want swagger-codegen to generate a function Foo with two parameters of the same type. For example Foo(User first, User second). For this to work, both "first" and "second" have the same $ref point...
Swagger Codegen
HKosova's avatar
HKosova
Icon for Alumni rankAlumni
6 years ago

To add description to a $ref, you can wrap the $ref into allOf:

first:
  description: The first user
  allOf:
    - $ref: '#/definitions/User'
  • belgi's avatar
    belgi
    New Contributor
    6 years ago

    Thank you.

    The description does work, however now the redoc does not recognize that the type of the first user is User and it is shown as type "object". 

    The swagger-codegen generates a Request class with no users as oppesed to the attempt in the post