[英]How to document Node typescript AWS serverless API?
My team is working on a new API using the Serverless aws-nodejs-typescript template.我的团队正在使用无服务器aws-nodejs-typescript 模板开发新 API。
In previous APIs we've used the aws or openAPI plugin for Serverless in order to document our APIs.在之前的 API 中,我们使用了无服务器的aws或openAPI插件来记录我们的 API。 However, we find it cumbersome since it requires an extra effort after development and implementation.但是,我们发现它很麻烦,因为它需要在开发和实施后付出额外的努力。 Also it might become outdated whenever the team drops the bar regarding keeping it up to date.此外,每当团队取消保持最新状态的标准时,它可能会变得过时。
We would like to use some kind of annotations similar to springdoc-openapi-ui for Java.我们想使用某种类似于 springdoc-openapi-ui for Java 的注释。 I've seen there exists a Typescript Swagger package , however it seems to be right choice when not using Serverless(AWS) but for instance Express .我已经看到存在一个Typescript Swagger 包,但是当不使用 Serverless(AWS) 但例如Express时,它似乎是正确的选择。
Has anyone used or found the right tooling to document Serverless AWS lambda APIs using Node and Typescript?有没有人使用或找到合适的工具来记录使用 Node 和 Typescript 的无服务器 AWS lambda API?
Any suggestion or hint will be more than welcomed!任何建议或提示都将受到欢迎!
Thanks!谢谢!
您可以尝试使用此链接中的插件serverless-aws-documentation
我解释了如何使用它
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.