草庐IT

Swagger3

全部标签

ruby-on-rails - 如何使用 grape swagger ui 传递数组?

我在下面定义了api端点:paramsdorequires:ids,type:Array,desc:'Arrayofgroupids'end我无法从Swagger生成的UI传递数组。如果我输入[1,2,3,4]或ids%5b%5d=1&ids%5b%5d=2&ids%5b%5d=3然后两者都无效.如果我使用数组调用spec中的api,它就可以工作。我的客户想尝试Swagger的整个api,所以我想要一个适用于SwaggerUI的解决方案。 最佳答案 我对所有情况的解决方案:paramsdorequires:ids,type:Arra

javascript - Swagger 和约会

我刚开始Swagger编写我的第一份规范。我发现了以下Swagger的“日期”类型*:------------------------------------------------|Commonname|Swaggerspec1.2|------------------------------------------------|string|string|------------------------------------------------|date|string,date|------------------------------------------------|

go-swagger - 找不到 swagger 服务命令

我正在尝试使用命令swaggerserve提供swagger.json文件,但出现错误Unknowncommand`serve'.Pleasespecifyonecommandof:generate,init,validateorversion从哪里获取服务命令的文档? 最佳答案 你用的是什么版本?serve是在0.7.x系列中添加的,因此您可能需要更新您的二进制文件。 关于go-swagger-找不到swagger服务命令,我们在StackOverflow上找到一个类似的问题:

go - 使用 go-restful 和 swagger 显示 PUT 正文格式

我正在使用go-restful和swagger来生成运行良好的apidoc。我面临的问题是,当我向文档添加主体参数时,我想指定数据类型及其格式。我可以指定数据类型(即UserFields),但JSON的格式不会显示在SwaggerUI中,这非常方便。这是我正在谈论的一个例子:以下链接显示了主体参数及其旁边相应的JSON/模型http://petstore.swagger.wordnik.com/#!/store/placeOrder在我的例子中,缺少JSON/模型,只显示数据类型http://ibounce.co:8282/apidocs/#!/users/PutUserField这是

Golang swagger 返回 404 not found

我遵循了这个github页面上的说明https://github.com/yvasiyarov/swagger使用示例项目和api文档生成的很好。但是当我运行最后一个命令来运行并显示API页面时,我去那里时总是得到404notfoundweb.go文件本质上是https://github.com/yvasiyarov/swagger/blob/master/web.go-example.它基本上是repo中web.go-example的副本......我不明白为什么它会返回404。另外,您对类似的api文档生成器有什么更好的建议吗?我不想要像https://github.com/go-

go - 如何在 Swagger 中创建前缀路由

通常swagger提供的示例设置简单的服务器,其中对json函数的所有api调用都在文档根目录中。例如著名的“helloworld”位于“/hello”。我想找到一种方法来定义给定的前缀,以便可以将特定的api放在这个前缀下。如果前缀为“/api/2.0”,则示例api将变为/hello-->/api/2.0/hello#Theprefixwouldbe"/api/2.0"/goodbye-->/api/2.0/goodbye#最后我想保持这种动态并真正提供一些命令行开关server-prefix'/api/2.0'服务器会将其用于api。请注意,我也可以不指定前缀,系统应该回退到“/

json - 使用 golang 将 xml 转换为 swagger 2.0 规范

我在将xml(WSDL)转换为golang中的swagger2.0规范时遇到问题。我在github上找到了一个将xml转换为普通json的库,但我需要转换为swagger2.0json。如果有的话建议我图书馆。提前致谢! 最佳答案 我建议您看看这些库:https://github.com/go-openapi.我使用它们,它们可以让你做几乎所有你需要的事情。您可以使用它们动态构建swagger2.0规范。但当然,您需要编写自定义代码来解析XML,将其转换为swagger结构,毕竟,您将能够将动态创建的规范写入json或yaml格式。

windows - 在 Windows 上安装 swaggo (swagger + gin)

我正在尝试在Windows上为gin-gonic设置swagger。swaggo的文档指出我应该运行:goget-ugithub.com/swaggo/swag/cmd/swag安装后我应该能够从我的项目的根目录中运行swaginit我有main.go,但是cmdlet声明如下:swag:Theterm'swag'isnotrecognizedasthenameofacmdlet,function,scriptfile,oroperableprogram.Checkthespellingofthename,orifapathwasincluded,verifythatthepathis

go - 如何在带有 http.ServeMux 的 GoLang lang 中使用 swaggo (swagger doc)?

在文档中https://github.com/swaggo/swag使用gin初始化服务器,但在我的应用程序中我使用http.ServeMux以及如何在不使用gin服务器的情况下初始化swaggo在文档中使用r.GET("/swagger/*any",ginSwagger.WrapHandler(swaggerFiles.Handler))我怎样才能使用...mu.Handle("/swagger/*any",swaggerFiles.Handler)……按照我最初的想法,但不工作...rsrsfuncServer()*http.ServeMux{docs.SwaggerInfo.Ti

go - 如何将 JWT 身份验证添加到 swagger (go + echo + swaggo/swag)

我正在使用swaggo(https://github.com/swaggo/swag)为我的API自动创建有效的swagger规范。swagger规范允许我运行所有API端点并接收响应。然后我将JWT身份验证添加到我的所有端点。现在我无法使用swagger规范来运行任何端点,因为它总是无法通过身份验证。我需要向每个端点添加哪些注释,以配置Swagger规范以允许传递JWT?我已经在https://github.com/swaggo/swag阅读了自述文件谷歌搜索无果。 最佳答案 似乎添加到每个端点的这些评论起到了作用......//