假设我有以下模式可供稍后使用$ref重用 "Order": { "properties": {{ "format": "int64" }它们之间唯一<e
浏览 21提问于2019-08-16得票数 5
回答已采纳
1回答
我们的业务希望创建一个Swagger文档来表示内部服务器。由于各种原因，每个请求都必须包含一系列无关的标头参数： - name: device_id required: false，但是参数本身与正在发出的请求无关，服务器将拒绝请求。Swagger文档的主要目的是生成少量客户端应用程序(所有这些应用程序我们都控制)来与服务器交互。
我们可以在每个请求中显式地添加每个参数，但这
浏览 0提问于2018-04-29得票数 1
回答已采纳
我试图使用OpenAPI 3创建API文档，但在参数定义中使用allOf关键字时会出现错误： parameters: name: idschema: format: int65 allOf: - name: dataSourceID
浏览 0提问于2018-09-04得票数 5
回答已采纳
我试图构建一个时间间隔的Swagger模型，使用一个简单的字符串来存储时间(我知道还有datetime)： Time: descriptionTimeInterval: properties: $ref: "#/definitions/Time"default: "00:00"
浏览 5提问于2015-11-10得票数 28
回答已采纳
我正在尝试将这个API导入到我的API管理中，但是我一直收到错误消息。
以下是azure管理中错误消息的屏幕截图：
浏览 1提问于2018-08-25得票数 1
回答已采纳
请描述您的问题地址：https://cloud.tencent.com/document/product/630/
浏览 202提问于2018-03-19
我使用的是swagger2.0，我有一个端点，它使用表单-数据作为请求的有效负载，我在几个地方使用相同的表单-数据体请求，我不想一次又一次地写它(重复它)，我不知道如何在yaml文件中建模它(当对象是请求体的一部分作为有效负载时这就是我试图建模的表单数据有效载荷：我查看了swagger的文档：
我不想复制相同的值(如果我这样做，它将工作，但解决方案将不是优雅的)。
浏览 1提问于2022-02-17得票数 1
我正在构建一个简单的OpenAPI 3 YAML规范，如下所示： /query: parameters: required: false format: integer现在，我想使用公共的bookid参数，但是将required值从f
浏览 0提问于2019-07-05得票数 4
realTimePaymentRequest required: true $refbe equal to one of the allowed values我可以看到，按照支持在: body中进行参数描述任何帮助都是非常感谢的。谢谢。
浏览 0提问于2020-02-14得票数 6
回答已采纳
希望你能帮我，这是我的问题： proxy_http_version 1.1;}
因此，对"“的任何请求都路由到FastAPI后端服务器，而发送到另一个端点的其他请求则被路由到前端SPA。例如，当我调用"/api/docs“端点时，有一个对"”地址的请求。显然，这不是以"&
浏览 3提问于2021-05-07得票数 6
我有一个C# WebAPI项目，它的方法使用自定义ModelBinder作为其输入参数。当我查看Swashbuckle生成的Swagger UI时，而不是有一个单一的"body“参数，方法的参数的所有属性都分别列出。如果我摆脱了ModelBinder属性并切换到使用FromBody属性，Swagger显示了正确的东西。我必须使用ModelBinder属性，所以关闭它不是一种选择。是否有一种方法可以让Swashbuckle生成
浏览 2提问于2015-05-24得票数 5
回答已采纳
我正在寻找一种优雅的方法来定义一个api，它既可以使用JSON数据，也可以使用表单数据。下面的代码片段可以工作，但它并不优雅，需要后端中所有丑陋的代码。有更好的方法来定义这个吗？现在起作用的： /pets: consumes: - applicationdescription: Updated name of the pet
required:
浏览 3提问于2017-02-17得票数 9
回答已采纳
我正在为swaggerhub创建一个组织良好的OAS3 swagger文档。对于每个端点，我写的所有可能的答案，如200,201,204,400,401,403,404,500等。此外，所有方法都有默认参数，如X语言代码等。我所处的位置使我使用的响应、模型、参数现在开始在每个文件中重复。经过一些研究，我了解到，我可以创建一个域和远程绝对url参考他们。: 'https://remote.example/url/2.0#&
浏览 2提问于2018-12-19得票数 1
回答已采纳
1回答
我的OpenAPI规范文件有问题。我试图调用一个公开的url来‘获取’一个id，但是每次我将服务转发到我的本地，然后尝试通过API文档发送请求时，我的连接就会被拒绝。我很感谢你的帮助。我期望的id是JSON格式的。下面是我的规范文件info: title: Id Generator
浏览 4提问于2017-06-20得票数 1
回答已采纳
2回答
当使用版本2.4.26 (“@openapitools/openapi生成器-cli”："^2.4.26")时，我得到的是失败的角服务(角验证13.2.0)。例如：它们将许多参数传递给角度HttpClient，这样代码甚至不会编译。我使用以下命令生成代码：openapi-generator-cli generate -i https://raw.githubusercontent.com/openapitool
浏览 13提问于2022-03-27得票数 0
1回答
我在将swagger设置到我的node.js应用程序时遇到了问题。我使用swagger-jsdoc和swagger-ui-express创建文档。openapi: 3.0.0 description: test title: U-CRM api documentationtags: description: CRM for university parameters
浏览 3提问于2020-02-17得票数 1
Eclipse Oxygen 3a with KaiZen-OpenAPI-Editor (0.8.0.201905261858)在组件->参数中指定path参数时显示警告。查询参数不显示此类警告。openapi: "3.0.0" version: 1.0.0paths: get:
浏览 22提问于2019-06-01得票数 0
回答已采纳
我试图使用swagger定义post端点，但它不允许使用requestBody参数： get: content: schema:当我运行npm start时，我得到了这样
浏览 4提问于2017-10-06得票数 7
回答已采纳
在Swagger2.0 (OpenAPI规范)中，有任何方法为请求体指定“示例”并指定引用吗？我可以作为一个反应机构这样做。我的例子是，对于某个PUT，主体是一个引用，但是您放置的实例将与模式的示例值不同。- name: myObj description: The information schema: ex
浏览 0提问于2018-02-21得票数 1
云服务器
ICP备案
实时音视频
对象存储
云直播
腾讯云开发者
