有没有一种方法可以将属性表示为一般的readOnly，但允许在POST或PUT (即创建或替换)操作期间写入属性？示例：
# OK example./AwesomeResource POST</
浏览 17提问于2020-02-07得票数 3
回答已采纳
我使用API3.0来描述一种OpenAPI，其中每个资源根据其操作具有细微不同的模式。本质上，根据是POST还是PUT请求，某些属性是可编辑的和/或必需的。(其中field2是PUT上的readOnly )
理想情况下，我希望在一个地方指定模式(即所有属性)，然后在每个操作上覆盖一些属性(例如readOnly)。"$ref":"#/component
浏览 0提问于2020-09-09得票数 1
我在.Net 5.0WebAPI中使用Swashbuckle (6.1.1)。我仍然在学习，但我希望实现一个类，其中某些属性仅在使用GET‘读取’时才有效，而在使用POST‘写’时则是有效的。例如，当GET返回比在POST中使用的属性更多的属性时，这是非常有用的--您可以在GET和POST中使用相同的模式，并将额外的属性标记为readOnly。readOnly属性
浏览 4提问于2021-04-07得票数 6
回答已采纳
我正在使用DRF-YASG在Swagger中记录API，并希望自定义/消除参数中显示的一些字段 我使用Django 2.1.7、DRF 3.9.2和DRF-YASG 1.14.0运行该项目。因此，我想删除swagger-ui中显示的ID (像'string‘和'path')，因为我通过Schema将它放在请求主体中，但是swagger-ui在参数中显示id (自动生成的字段)。request_category_put</e
浏览 51提问于2019-03-24得票数 2
阅读此 (参见:3如何在.时使用单个定义)关于使用OpenAPI (Swagger)规范来描述REST，您可以注意如何使用readOnly属性保留一个用于添加/更新和获取资源的资源表示，而不是只有一个表示用于获取(获取一个集合项)，另一个表示用于添加(POST到集合)。例如，在下面的用户单一表示中，id是一个只读属性，这意味着在创建用户时它不会在表示中发送，当用户被检索时它将在那里。假设在创建用户(POST / user /
浏览 0提问于2016-12-14得票数 0
当我在SwaggerHub上生成API规范时，我可以声明模式，包括用户友好的示例，如下所示： schemas: type: objecttype: string example: '2019-10-01'
我不知道如何使用ServiceStack OpenAPI中的属性生成相同的内容。我是否要在响应DTO上添加属性？还是我喜欢的类型？我找不到任何与"ex
浏览 4提问于2019-08-06得票数 1
例如，在body part.Can中，我做了一些事情，让我在structure1和structure之间做出选择，就像在enum.Here中一样，这也是我的结构和结构。我们有像选择器这样的东西吗，或者每次我都应该为每个结构创建新的POST或PUT ?可能还有其他方法来处理if ?我们在swagger中有if吗？openapi: 3.0.0 - url: 'http://petstore.swagger.io/
浏览 1提问于2017-08-30得票数 1
我有多个请求体，它们需要使用相同的枚举，但很难在多个模式中引用单个定义。在我的openapi.yaml文件中，我包括： schemas: type: string - THING在我的帖子/投递请求的正文定义中，我包括： schema:
$ref: '#/../o
浏览 13提问于2022-07-20得票数 0
3回答
我最近正在学习OpenAPI，并且想知道最佳实践。假设我有一个名为Person的资源，它在components/schemas中定义如下： type: object - id type: integer
我创建了id readOnly，因为当我执行post或patch时，ID将作为URL的一部分传递。我使用PUT进行更新，并且总是传递所有必需的字段。但如果我的数据过时了呢？与方法3一样
浏览 9提问于2020-06-13得票数 15
因此，我正在开发数据传输对象文件中的组件yaml文件，以便能够引用它们。_type = "VerifiedEmailAddressDto"; readonly reset: boolean; this.reset = reset; }passwordRules的最后一个
浏览 1提问于2021-12-01得票数 2
回答已采纳
但是，当我在Nodejs中使用下面的swagger时 * /parser: * summary: Get scenario validation
浏览 7提问于2022-08-22得票数 0
但看起来是这样的：{ private readonly IReporterRepository _reporterRepository;
Description = "All reporters&quo
浏览 0提问于2021-11-27得票数 3
回答已采纳
我使用SwaggerCore2.0生成openAPI 3.0定义文件 "/auth" : { "summary" : "authenticate user",security = {}se
浏览 2提问于2018-06-01得票数 2
default="") print "fired"$ q = SomeModel.query().get()John$ q.put()但是，如果valid属性从例如：
$ q = SomeMod
浏览 2提问于2018-01-31得票数 2
回答已采纳
有谁知道如何在Swagger 2.0定义中定义可能的'enum‘值，以便它们显示在OpenAPI UI的模型选项卡中？示例如下:对于status属性，有一个枚举选项。如何在OpenAPI 2.0中定义这样的枚举？
浏览 1提问于2014-12-22得票数 62
2回答
我在通过HTTP向WCF数据服务(OData)执行PUT请求时遇到了问题。问题是ID。它不是自动生成的，我不能更改DB设置(在本例中是不允许的)。FDisplayDescription").val(); alert(jr);
type: "PUT我试过在它后面加一个+"L“(WCF很喜欢它.)但它就是不能解析！作为误差
<em
浏览 0提问于2012-03-07得票数 0
回答已采纳
我们确实希望这种区别是明确的，因此任何阅读OpenAPI规范的工具都知道确切的期望。所以我的问题是：openapi: 3.0.2 title: Person API '/persons/{person-slug- $ref: '
浏览 0提问于2019-03-04得票数 3
回答已采纳
我在JSON定义中向parameters部分添加了以下内容： "name": "File", "required": true, "dataType": "
浏览 32提问于2013-01-22得票数 73
回答已采纳
9回答
是否有人成功地将参数隐藏在生成的文档中？我发现了的一个问题，但是在@HeaderParam之前使用@ApiParam(access="internal", required=false)似乎不起作用。
浏览 8提问于2014-04-02得票数 21
回答已采纳
我们实现了2.6.1版本的spring fox swagger 2，我想为HTTP GET方法而不是POST方法显示资源的特定属性，我还没有找到任何使用swagger 2的方法。请帮助谢谢。Integer id;请求URI: GET /api/employee/{id}我应该看到swagger请求文档为 id:"",}
请求URI: POST
浏览 6提问于2017-02-21得票数 5
云服务器
ICP备案
对象存储
云点播
实时音视频
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号