パス項目のスワッガー検証エラー：「追加プロパティが許可されていません」

Question

https://www.npmjs.com/package/swaggerを使用していますが、設定を作成しようとしています。私は

 "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の、このような部分を持っている。しかし、私は闊歩を実行したときに、私はこのエラーを取得しておく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"

威張っ-OpenAPIの2.0仕様の関連部分がPaths Object定義であるべきです。