REST: generate REST API with multiple response

How To
1

Hi,
the generated doc of a REST service with multiple response scenarios apparently processes only the first scenario and discards the others. In the example shown in the following images I do not find any reference of link to the 404 scenario.
Am I missing or doing something wrong?

Immagine2
Immagine21964×1700 190 KB

Immagine
Immagine2218×720 141 KB

2

Hi LibAdri,

Thank you for your post. I have forwarded your case to our engineers to study. When there is any news, I will let you know.

Best regards,
Jick Yeung

3

Thank you Jick!

4

Any news about this behaviour?
Perhaps it is a bug? To be posted into the bugs section?

5

Hi LibAdri,

Your case is still on the queue. I will post here when there is any update. Sorry to keep you waiting.

Best regards,
Jick Yeung

6

Hi LibAdri,

The issue associated with REST API document generation has been fixed. You can update to the latest patch build to obtain the fix. For details, please read:

Best regards,
Jick Yeung

7

Hi Jick,

thank you to developers and you for the patch.
I have installed it and tested.
It has been improved as it generates documentation for all responses having a class result.
Unfortunately, it does still discard all empty responses like NOT FOUND and NO CONTENT which are not linked to any class result: for these cases no documentation is generated.

Moreover, it would be nice to get the UML related to a REST Service class automatically included into the API documentation. :slight_smile:

8

hi LibAdri,

Thanks for trying that out. I have just forwarded your feedback to our engineers to study. When there is any update, I will let you know.

Best regards,
Jick Yeung