Ошибка проверки Swagger в элементе пути: «Дополнительные свойства не разрешены»

Question

Я использую https://www.npmjs.com/package/swagger, и я пытаюсь создать конфигурацию. У меня есть такая часть моего swagger.js

 "dummy\/{id}\/related_dummies": { 
      "get": { 
       "tags": [ 
        "RelatedDummy" 
       ], 
       "operationId": "get_by_parentRelatedDummyCollection", 
       "produces": [ 
        "application\/ld+json", 
        "application\/hal+json", 
        "application\/xml", 
        "text\/xml", 
        "application\/json", 
        "text\/html" 
       ], 
       "parameters": [ 
        { 
         "name": "id", 
         "in": "path", 
         "required": true, 
         "type": "integer" 
        } 
       ], 
       "summary": "Retrieves the collection of RelatedDummy resources.", 
       "responses": { 
        "200": { 
         "description": "RelatedDummy collection response", 
         "schema": { 
          "type": "array", 
          "items": { 
           "$ref": "#\/definitions\/RelatedDummy" 
          } 
         } 
        } 
       } 
      } 

Но когда я бег чванства проверки swagger.js я получаю эту ошибку:

Project Errors 
-------------- 
#/paths: Additional properties not allowed: dummy/{id}/related_dummies 
Results: 1 errors, 0 warnings 

Что может быть причиной ошибки? Спасибо

Answer 1

Проблема в том, что путь dummy/{id}/related_dummies не начинается с косой черты.

Чтобы быть признанным действительным объектом объекта пути, он должен быть /dummy/{id}/related_dummies.

Используя сбежавшего синтаксис из вашего примера, имя должно быть "\/dummy\/{id}\/related_dummies"

Соответствующая часть 2.0 спецификации Форс-OpenAPI находится в Paths Object определения.