-
1 votesanswersviews
如何为REST API生成Swagger文件
我的要求是为给定的ReST API URL生成Swagger文件 . 我使用POSTMAN客户端调用了下面提到的URL,它工作正常 . 但是,要在Informatica中使用此URL,需要将关联的Swagger文件设置为json或yaml格式 . 我只是ReST API的最终用户,并且不知道它的代码 . 以下是使用的网址 . https://app.informaticaondemand.com/... -
0 votesanswersviews
如何使用swagger代码生成器
我正在创建其余的客户端,我将调用一个API来提供这个大的json输出 . 我想知道如何通过输入这个json到swagger代码来自动创建Pojo类,让它为我创建我的pojo类这将节省手动时间 . 这是我尝试过的 要为http://petstore.swagger.io/v2/swagger.json生成PHP客户端,请运行以下命令 git clone https://github.com/swag... -
0 votesanswersviews
Swagger:不允许使用其他属性:allOf
我试图通过使用 allOf 来找出这个摇摆不定的API继承的东西 . 这是我大摇大摆的yaml文件 . swagger: '2.0' info: title: Test API version: '1' basePath: /api/v1 schemes: - https produces: - application/json paths: /users: get:... -
0 votesanswersviews
Swagger annotations和Swagger spec 2.0
我开发了一个带有Swagger注释的REST API . 我已经能够在swagger-ui应用程序上显示api文档,非常好 . 问题:我'm trying to generate clients acording this specification using the url provided by swagger acording my anotations. The porblem is i... -
0 votesanswersviews
如何在c#中的窗口应用程序中使用swagger web api
我有一个Web API URL,以swagger UI格式显示API信息 . 我想使用Web API URL从Swagger codegen生成客户端库 . 当我们在https://editor.swagger.io中导入URL时,请告诉我如何传递用户名和密码 . 在我的情况下,当我导入url时,它显示身份验证错误,因为此url需要用户名和密码进行身份验证 . 根据Swagger示例,当我尝试使用... -
1 votesanswersviews
如何使用包含验证信息的Swagger Codegen为Typescript-Angular2生成代码
我使用swagger-codegen 2.2.3版为typescript-angular2生成API - 到目前为止一切都很好 . 我使用的命令是: java -jar ./swagger-codegen-cli-2.2.3.jar generate -i http://example.ch/swagger/docs/v1 -l typescript-angular2 -o ./src/api... -
0 votesanswersviews
Swagger UI生成错误的Curl命令
Swagger UI生成错误的Curl命令,粘贴在下面并且由于此查询字符串截断 卷曲-X GET http://domain:8080/v1/endpoint?access_token=affsfafasfa&type=1 -H "accept: application/json" -H "content-type: application/json"... -
0 votesanswersviews
swagger编辑器生成不会POST的typescript客户端
我已经使用位于http://editor.swagger.io的Swagger编辑器生成了一个Angular2打字稿客户端 . 虽然POST endpoints 永远不会被发送到服务器,但API适用于所有非 POST 类型的api endpoints . 到达生成的typescript中的以下方法,并且 console.log 语句显示正在设置标头,尽管实际上没有POST到服务器 . 这表明 t... -
0 votesanswersviews
Swagger-ui - 无法弄清楚Petstore的某些功能是如何运作的
我已下载并浏览到Swagger-UI dist / index.html文件,并且已加载示例Petstore API . 但是,我无法弄清楚某些功能是如何运行的,因此无法将其纳入我自己的定义 . 示例Petstore在右下角显示"VALID "按钮 . 但是,当我导航到我自己的API定义时,我没有看到 . 我该如何启用它? 当我查找由Swagger-UI http:/... -
3 votesanswersviews
如何定义Swagger 2.0 JSON以在Swagger UI中填充默认的body参数对象?
我们当前的部署模式要求我手动编写我的swagger json输出,该输出将由我公司使用的基于Swagger的UI使用 . 我希望我正在编写的json提供'default'值来填充所有输入字段的Swagger UI,包括body输入参数 . 我的body参数是一个引用的对象,如下所示 . 当单击“尝试此操作”时,如何定义返回的swagger JSON以自动填充请求的正文部分? 下面是Swagger ... -
2 votesanswersviews
swagger-editor vs swagger-codegen
我是一个招摇的新手,我一直在尝试用swagger编辑开发api . Swagger-codegen声明这是一个开源代码生成器,可直接从Swagger定义的RESTful API构建服务器存根和客户端SDK . 当我使用swagger-editor时,我可以看到选项:生成服务器和生成客户端(我在本地运行swagger-editor) swagger-codegen是否具有与swagger-edito... -
0 votesanswersviews
如何在Swagger编辑器中使用JSON主体指定POST
我有一个POST方法REST API,请求体为json,它有 { "name": "5-Star", "vendor": "Cadbury", "description": "More almonds with chocolate", "... -
4 votesanswersviews
Swagger UI / Editor like page - 添加到我的网站
我通过swagger editor手动创建了YAML文件(和JSON文件) . 现在我想将来自swagger-editor工具的酷炫自动生成页面嵌入到我的网站中,这样用户就可以通过我的API实时阅读和测试它(通过“尝试此操作”按钮) . 我不想让swagger为我生成任何代码,我也不需要它自动更新文档(YAML或其他) . 每当我需要时,我都会手动更新我的静态YAML / JSON文件 . 招摇是... -
2 votesanswersviews
从Swagger文档生成Yaml或Json文件
我使用swagger-springmvc注释开发了一些由swagger记录的Rest Web服务 . 现在,我想使用swagger-editor生成客户端Rest Web服务代码,但swagger-editor需要Yaml或Json文件 . 你知道是否有办法生成这个文件?提前谢谢 EDIT : 它's can be done by using swagger-mvn-plugin , but I ... -
0 votesanswersviews
Swagger创建API文档:Swagger编辑器
我正在使用swagger来记录我的REST API服务 . 我有一个特定的输入,我提供给服务 . 我正在使用swagger编辑器自己创建YAML代码 . 我面临的问题是我无法将输入类型作为XML获取,默认情况下它采用JSON . 我的yaml代码中是否有任何问题 . 代码如下: swagger: "2.0" info: title: Order Update to Dealer... -
0 votesanswersviews
使用Swagger编辑器记录REST API
我必须使用Swagger编辑器为其中一个应用程序记录REST API . 我已经浏览了一些可用的参考资料,但似乎没有任何东西显示出记录API的起点 . https://swagger.io/docs/swagger-tools/#installation-11 已经下载了Swagger编辑器,并希望开始记录 . 任何特定的指针都可以帮助你 . 谢谢 . 问候,-Nayan Parikh -
1 votesanswersviews
Swagger为自定义Restful API生成定义(C#.NET)
我正在尝试使用swagger作为我的RESTful api(.net和c#) . 它是一个自定义的restful api(不是ASP.NET Web API,也不是Web应用程序) . public interface IEmployee { [CustomSecurity(Session.Required)] EmployeeResponse GetEmployee(Employ... -
4 votesanswersviews
在Swagger中创建复杂类型(定义)
我创建了一个名为 Product 的定义,另一个名为 Text (参见代码) . 在 parameters paths 我无法使用定义中创建的 Text 类型 . 在定义 Product 我有一个名为 message 的属性,我希望该属性也是 Text 类型 . (...) paths: /products: get: summary: Product Types ... -
1 votesanswersviews
尝试使用时Swagger架构错误
我有一个类似的错误Swagger Schema error should NOT have additional properties,但在我的情况下,我感谢一些帮助 . 我尝试制作一个显式对象: responses: '200': content: application/json schema: t... -
12 votesanswersviews
具有动态键值哈希映射的Swagger复杂响应模型
我正在努力用swagger的语法来描述一个响应类型 . 我想要建模的是具有动态键和值的哈希映射 . 这是允许本地化所必需的 . 语言可能会有所不同,但应始终提供英语 . 响应在JSON中看起来像这样: { id: "1234", name: { en: "english text", de: "Deutscher Text&... -
0 votesanswersviews
如何从javascript访问swagger yaml定义的对象
我使用Swagger Yaml来描述 endpoints 并生成模拟服务器 . 现有 endpoints (我正在嘲笑)不遵循RESTful原则100%,所以我只想覆盖模拟服务器返回的响应 . 简单的服务器代码如下所示: var swagger = require('swagger-server'); var server = swagger('map-cache... -
1 votesanswersviews
如何在不破坏Codegen的情况下在Swagger中添加几个示例来响应?
我一直在尝试根据official docs向我的Swagger API添加示例(请参阅请求和响应正文示例的最后一个代码块),但它似乎没有按预期工作 . 考虑以下最小的例子: swagger: "2.0" info: description: Desc version: "1" title: Title paths: /stuff: p... -
4 votesanswersviews
Swagger POST Json Body参数模式YAML
我正在使用swagger-api和swagger-editor处理RESTful API . 我无法弄清楚为什么我通过身体发送的JSON,从未到达我的控制器 . 这是我的YAML schemes: - http - https produces: [application/json, multipart/form-data, application/x-www-form-urlencod... -
4 votesanswersviews
Swagger UI - 如何自己显示模型列表
在Swagger编辑器示例http://editor.swagger.io/#/中,稍后在显示 endpoints 后的渲染文档中有一个"Models"部分 . 这只是这个编辑器的一个功能,可以看到你如何定义它们,或者这也可以在Swagger UI中显示所有模型? (如果它们也可以显示在 endpoints 信息之外,那将是非常好的,特别是对于已定义但尚未使用的模型......... -
2 votesanswersviews
Swagger中的多个项目的数组
所以我正在创建一个带有nodejs的用户 endpoints 来将用户添加到数据库中,而对于api文档我正在使用swagger编辑器,我对它完全不熟悉 . 我想要做的是添加一个用户登录,密码,头像,但该用户有多个角色我想添加到数据库我在swagger编辑器中的yaml文件中做的是这个 /users/add: post: description: '' operationId: AddUser pa... -
12 votesanswersviews
如何在Swagger中指定GET参数的示例?
我正在使用在线Swagger Editor为我的API创建一个Swagger规范 . 我的API有一个GET请求 endpoints ,我使用以下YAML代码来描述输入参数: paths: /fooBar: get: tags: - foobar summary: '' description: '' operationI... -
6 votesanswersviews
为AWS API Gateway生成swagger json定义
作为我们持续交付管道的一部分,我将部署AWS API Gateway API . 最简单的方法是使用Amazon API Gateway Importer,它可以从Swagger表示创建或更新Amazon API Gateway API . AWS提供API Gateway Extensions to Swagger . 通过这些扩展,您可以在Swagger定义中提供请求/响应模板 . 下面是一个... -
9 votesanswersviews
node.js上swagger中的可空字段
我花了很多时间试图找到在Node.JS中创建swagger文档的解决方案 . 主库是swagger-node,在其中创建一个swagger yaml文件,然后将控制器添加到它 . 它会自动在您的应用中提供swagger ui文档,并根据您在yaml中指定的模型对请求和响应进行验证 . 这很简洁,但是我要求某些字段我想明确地返回或接受 null 作为值,例如: { id: 123, des... -
2 votesanswersviews
Swagger UI:数组中的多个匿名对象
我正在为API编写Swagger文档,并且一个 endpoints 返回许多嵌套对象和参数 . 但是,有一个返回的数组,它不返回常规参数 . 相反,它返回两个包含参数的匿名对象 . "balanceDisplaySettings": [ { "type": "Balance", "label": ... -
27 votesanswersviews
Swagger编辑体内的多个参数
所以我理解,如果我们想要身体参数,我们必须有一个模式,我这样做 . 问题是无论我如何尝试定义我的架构,它都不允许我有多个body参数 . 这是我尝试过的方法之一的示例 . 任何帮助都会很棒! swagger: '2.0' # This is your document metadata info: version: "0.0.1" title: Todo App sc...