闊歩エラー - 説明：「未有効なパラメータの定義」

Question

私は残りのAPIのためのシンプルな闊歩定義を定義しようとしています。すべてのパラメータセクションでエラーが発生しています。

私が闊歩エディタで、次の闊歩定義エラーを取得しています、私は何が間違っている任意の手掛かりを得ていないのです。お知らせ下さい。

闊歩定義：

paths: 
'/customer/{customerId}/accountlist': 
get: 
    responses: 
    '200': 
     description: '' 
    parameters: 
    - name: customerId 
     in: path 
     allowMultiple: false 
     required: true 
     type: string 
    x-auth-type: None 
    x-throttling-tier: Unlimited 
    produces: 
    - application/json 
    x-scope: InternalUse 
    swagger: '2.0' 
    info: 
    title: Sample 
    description: API for Sample 

闊歩エラー：

Swagger Error 
Not a valid parameter definition 
Jump to line 7 
Details 
Object 
code: "ONE_OF_MISSING" 
params: Array [0] 
message: "Not a valid parameter definition" 
path: Array [5] 
0: "paths" 
1: "/customer/{customerId}/accountlist" 
2: "get" 
3: "parameters" 
4: "0" 
schemaId: "http://swagger.io/v2/schema.json#" 
inner: Array [2] 
0: Object 
code: "ONE_OF_MISSING" 
params: Array [0] 
message: "Data does not match any schemas from 'oneOf'" 
path: Array [5] 
0: "paths" 
1: "/customer/{customerId}/accountlist" 
2: "get" 
3: "parameters" 
4: "0" 
inner: Array [2] 
0: Object 
code: "OBJECT_MISSING_REQUIRED_PROPERTY" 
params: Array [1] 
0: "schema" 
message: "Missing required property: schema" 
path: Array [0] 
1: Object 
code: "ONE_OF_MISSING" 
params: Array [0] 
message: "Data does not match any schemas from 'oneOf'" 
path: Array [0] 
inner: Array [4] 
1: Object 
code: "OBJECT_MISSING_REQUIRED_PROPERTY" 
params: Array [1] 
0: "$ref" 
message: "Missing required property: $ref" 
path: Array [5] 
0: "paths" 
1: "/customer/{customerId}/accountlist" 
2: "get" 
3: "parameters" 
4: "0" 
level: 900 
type: "Swagger Error" 
description: "Not a valid parameter definition" 
lineNumber: 7 

Answer 1

私はあなたのOpenAPIの仕様を書き直しました。このバージョンでは有効です。

swagger: '2.0' 

info: 
    title: Sample 
    version: 1.0.0 
    description: API for Sample 

paths: 
    '/customer/{customerId}/accountlist': 
    get: 
     responses: 
     '200': 
      description: '' 
     parameters: 
     - name: customerId 
      in: path 
      required: true 
      type: string 
     x-auth-type: None 
     x-throttling-tier: Unlimited 
     produces: 
     - application/json 
     x-scope: InternalUse 

あなたの元のバージョンに関するいくつかのコメント：

• はインデントが悪かったです。たとえば、get:行は、前の行からインデントする必要があります。しかし、おそらくそれは単なるコピー&の貼り付け問題でした。

• infoオブジェクトには、versionプロパティが必要です。

• customerIdパラメータはallowMultipleプロパティが含まれています。私はそれを取り除くまで、私は誤りを見ていた。