topic Re: Talend ESB - How to configure and edit server-generated Swagger docs in Talend Studio

Talend ESB - How to configure and edit server-generated Swagger docs

Anonymous — Sat, 16 Nov 2024 07:40:04 GMT

I develop REST endpoints using Talend ESB, and I would like to take advantage of the built-in ability to generate swagger documentation for my services, that are accessible via https://my-server.com/services/my-service/api-docs?url=/services/my-service/swagger.json. The swagger docs are generated just fine. However, I am unable to provide models, example parameters, etc. for my users. Here is an example of what I want (this comes from the swagger ui for the talend cloud API):

How can I do this? How do I learn more about Talend ESB Swagger? There doesn't seem to be any documentation online. Can the Talend team please create some useful documentation for this feature? As it stands it is pretty much unusable.

Re: Talend ESB - How to configure and edit server-generated Swagger docs

vapukov — Thu, 13 Sep 2018 10:15:14 GMT

just want add one more voice - good to have this information (or feature if not exists)

right now - this is skipped in documentation (at least I not found too)

Re: Talend ESB - How to configure and edit server-generated Swagger docs

martel — Tue, 25 Sep 2018 10:23:54 GMT

hey,

Talend Team : why you dont let option create swagger into componant tRestRequest on Talend Open Studio.

this is only add into main code this annotation :

@EnableSwagger2

But why you add into lib swagger core into .jar osgi package, if i cant use it ?

2018-09-25_11-22-39.jpg

Re: Talend ESB - How to configure and edit server-generated Swagger docs

vapukov — Tue, 25 Sep 2018 10:30:50 GMT

🙂

generally - of course good to have this functional ... but this is one from the list "what difference between Community and Enterprise versions"

Re: Talend ESB - How to configure and edit server-generated Swagger docs

martel — Tue, 25 Sep 2018 10:41:31 GMT

for me it is stupid, only one annotation.... and talend effort are zero to add....

and let library into package osgi bundle when open studio create this by default.

Re: Talend ESB - How to configure and edit server-generated Swagger docs

Anonymous — Mon, 01 Oct 2018 23:40:41 GMT

Hi, looking for an update on this. Or is this just a broken feature??