当前位置: 首页 > 知识库问答 >
问题:

OpenAPI 3.0 文件格式在参数中给出允许值的错误

西门建安
2023-03-14

我在OAS 3.0中指定了API规范

post:
  tags:
    - One Time Payment
  summary: One Time Payment API
  operationId: oneTimePaymentUsingPOST
  parameters:
    - in: body
      name: realTimePaymentRequest
      description: realTimePaymentRequest
      required: true
      schema:
        $ref: '#/components/schemas/RealTimePaymentRequest'

当我在https://editor.swagger.io/编辑这个规范文件时,它抛出如下错误:

Structural error at paths./banks/payments.post.parameters.0.in
should be equal to one of the allowed values
allowedValues: path, query, header, cookie

我可以看到,根据 https://swagger.io/docs/specification/2-0/describing-request-body/ 支持在参数中描述:正文

以为Swagger编辑器抛出错误。这里会有什么问题呢?图式?

感谢您的帮助。非常感谢。

共有1个答案

谭嘉歆
2023-03-14

在OpenAPI 3.0中,:body中的和:formData中的参数被替换为requestBody

post:
  tags:
    - One Time Payment
  summary: One Time Payment API
  operationId: oneTimePaymentUsingPOST

  requestBody:
    description: realTimePaymentRequest
    required: true
    content:
      application/json:
        schema:
          $ref: '#/components/schemas/RealTimePaymentRequest'

你发布的文档链接是针对OpenAPI 2.0的。对于OpenAPI 3.0,请使用以下链接:< br > https://swagger . io/docs/specification/descripting-request-body/

 类似资料:
  • 假设我的OpenAPI定义有两个服务器。两者共享相同的变量。因此,我想引用这些变量来防止重复代码。 是否可以引用服务器变量或以另一种方式重用它们? 当然,我可以运行,但我不想使用它。

  • 在sfa dele内部,我们有一些配置。 其中一个是 在Google关于Sceneform的I/O视频中,据说它可以从0到255,我们通常应该使用0到1。 我的第一个问题,关于我们应该使用的代码:0, 0.2, 0.4, 1还是0, 20, 40, 255? 其次,使用Android的Sceneform示例之一,我尝试在“solarSystem”示例中更改Sun的该值。但无论做什么改变,看起来都是

  • 问题内容: 我的问题是我尝试在查询中插入包含char的文本 我试图在char之前加上双反斜杠//,但仍然无法正常工作。 问题答案: 在这里,Hibernate正在解析一个插入,该插入包含其中带有冒号的硬编码值。如果您重写插入以使用参数,则Hibernate将不会在语句中看到该值。

  • 但是在OpenAPI3.0.0中,参数被请求体替换,我找不到定义头参数的方法,这将进一步用于身份验证。 在OpenAPI3.0.0中定义请求头的正确方法是什么?

  • 我使用下面的代码来格式化日期。但是当我以不正确的格式给出数据时,它会给出意想不到的结果。 在上述情况下,输出为-formattedVal:0009-02-05。 它不是抛出解析异常,而是解析值并给我一个不正确的输出。有人能帮我理解这种反常的行为吗。

  • 我在Ubuntu 18.04和php7.3上使用phpmyadmin,当我尝试导入或导出文件时,会显示以下错误: ./libraries/plugin_interface.lib.php#551 count()中的警告:参数必须是数组或实现可计数的对象,所以我转到这个文件(plugin_interface.lib.php)并尝试将$options强制转换为数组,但仍然不起作用