Как я могу использовать открытый документ Openapi Swagger UI? - PullRequest
0 голосов
/ 21 апреля 2020

Я проверяю последний код из Swagger UI 3.25.0 на GitHub и добавляю некоторые функции, такие как сохранение и загрузка данных рекветов. Он отлично работает с Swagger 2.0 do c, который имеет json файл, подобный этому

{
   "swagger":"2.0",
   "info":{
      "version":"1.0",
      "title":"Order api",
      "description":"Order api"
   },
   "paths":{
      "/api/v1/internal/orderdispatch/DispatchOrder/DispatchOrdersByIdList":{
         "post":{
            "tags":[
               "Myaz.OrderDispatch.API.Controllers/DispatchOrder"
            ],
            "operationId":"POST_api_v1_internal_orderdispatch_DispatchOrder_DispatchOrdersByIdList",
            "consumes":[
               "application/json-patch+json",
               "application/json",
               "text/json",
               "application/*+json"
            ],
            "produces":[
               "application/json"
            ],
            "parameters":[
               {
                  "name":"salesOrderIdList",
                  "in":"body",
                  "required":false,
                  "schema":{
                     "uniqueItems":false,
                     "type":"array",
                     "items":{
                        "type":"string"
                     }
                  }
               }
            ],
            "responses":{
               "200":{
                  "description":"Success"
               }
            },
            "deprecated":false
         }
      },
   }
}

Но кажется, что он не может открыть OAS 3.0 do c, который имеет следующую структуру.

{
  "openapi": "3.0.1",
  "info": {
    "title": "My API",
    "version": "v1"
  },
  "paths": {
    "/api/v1/OrderRouter/SalesOrder/CreateSalesOrder": {
      "post": {
        "tags": [
          "SalesOrder"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Myaz.ERP.Model.OrderRouter.ViewModel.SalesOrderViewModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/Myaz.ERP.Model.OrderRouter.ViewModel.SalesOrderViewModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Myaz.ERP.Model.OrderRouter.ViewModel.SalesOrderViewModel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      }
    },
  }
}

В настоящее время я использую asp. net ядро ​​3.1, которое поддерживает только OAS c. Так как же использовать swagger UI, чтобы OAS 3.0 делал c? Заранее спасибо.

...