Формат файла OpenAPI 3.0, выдающий ошибку в параметрах allowValues - PullRequest
Новая
       42

Формат файла OpenAPI 3.0, выдающий ошибку в параметрах allowValues

0 голосов
/ 14 февраля 2020

У меня есть API Spe c, указанное в OAS 3.0 

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'

Когда я редактирую этот файл spe c в 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

Я вижу, что описание в: body в параметрах поддерживается согласно https://swagger.io/docs/specification/2-0/describing-request-body/

, думал, что Swagger Editor выдает ошибки. Что здесь может быть не так? схема?

Любая помощь приветствуется. Спасибо.

1 Ответ

1 голос
/ 14 февраля 2020

В OpenAPI 3.0 параметры in: body и in: 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 используйте эту ссылку:
https://swagger.io/docs/specification/describing-request-body/

...