topic Re: Swagger documentation for custom REST API in Alfresco Forum https://connect.hyland.com/t5/alfresco-forum/swagger-documentation-for-custom-rest-api/m-p/78040#M24460 <HTML><HEAD></HEAD><BODY><P>About the 'API first approach':&nbsp;</P><P>There already is some tooling around to generate&nbsp;source code from OpenAPI / Swagger documentation, e.g. <A href="https://github.com/swagger-api/swagger-codegen" rel="nofollow noopener noreferrer">swagger-api/swagger-codegen</A> or <A href="https://github.com/OpenAPITools/openapi-generator" rel="nofollow noopener noreferrer">OpenAPITools/openapi-generator</A>.&nbsp;</P><P>From my experience with these tools, I think it might be possible to use it in the context of Alfresco if the generators are provided with the correct templates.&nbsp;</P><P></P><P>I&nbsp;wonder if someone already tried creating&nbsp;such templates for auto-generating Alfresco WebScripts? Might be a good Hack-a-thon project :-)?</P></BODY></HTML> Fri, 19 Jul 2019 08:24:02 GMT kerkhofsd 2019-07-19T08:24:02Z Swagger documentation for custom REST API https://connect.hyland.com/t5/alfresco-forum/swagger-documentation-for-custom-rest-api/m-p/78039#M24459 Hi,in our ACS-based projects we usually&nbsp;develop&nbsp;many custom REST APIs using the default extension points provided by Alfresco:XML descriptor (*.desc.xml)JAVA controller (extending&nbsp;org.springframework.extensions.webscripts.DeclarativeWebScript)JS controllerFTL templateseccI would like to know if&nbsp;ther Thu, 29 Mar 2018 12:43:33 GMT https://connect.hyland.com/t5/alfresco-forum/swagger-documentation-for-custom-rest-api/m-p/78039#M24459 luca_ow 2018-03-29T12:43:33Z Re: Swagger documentation for custom REST API https://connect.hyland.com/t5/alfresco-forum/swagger-documentation-for-custom-rest-api/m-p/78040#M24460 <HTML><HEAD></HEAD><BODY><P>About the 'API first approach':&nbsp;</P><P>There already is some tooling around to generate&nbsp;source code from OpenAPI / Swagger documentation, e.g. <A href="https://github.com/swagger-api/swagger-codegen" rel="nofollow noopener noreferrer">swagger-api/swagger-codegen</A> or <A href="https://github.com/OpenAPITools/openapi-generator" rel="nofollow noopener noreferrer">OpenAPITools/openapi-generator</A>.&nbsp;</P><P>From my experience with these tools, I think it might be possible to use it in the context of Alfresco if the generators are provided with the correct templates.&nbsp;</P><P></P><P>I&nbsp;wonder if someone already tried creating&nbsp;such templates for auto-generating Alfresco WebScripts? Might be a good Hack-a-thon project :-)?</P></BODY></HTML> Fri, 19 Jul 2019 08:24:02 GMT https://connect.hyland.com/t5/alfresco-forum/swagger-documentation-for-custom-rest-api/m-p/78040#M24460 kerkhofsd 2019-07-19T08:24:02Z