The Expose Swagger specification option/feature within RESTful Data Services and Routes (tRESTRequest / cREST) produces Swagger UI (online API documentation) but in a very basic form. Is it possible to improve it to add more features such a model, an example, and a description of the generated documentation?
Answer
The Swagger API documentation generation for restful components is now deprecated.
The main reason is to shift and improve support for contract-driven design/approach, where you start with the API Contract (which can be in the form of Swagger) before implementing the service. Indeed, contract-driven is the methodology Talend recommends. In general, it fosters the creation of better quality APIs, that meets API consumer expectations, and overall reduces the time to market, by fixing the API design problems early on, rather than after the implementation has already been done.
Going forward, Talend API Designer can be used in combination with Studio Routes and Data Services to achieve this. This is available in the Talend Cloud API Services product.
