【Swagger】URIにパラメーターが入るときはパラメーターを定義しよ。

はじめに

現在個人的に開発しているWEBサービスでちゃんとAPIドキュメント残さないと、仲間が増えた際に働けないかなと思いSwaggerを使ってドキュメントを書いています。

→実際はエクセルで書いていたが、エンジニアに「Swaggerで書いて！」っていわれたので、なにそれ的？につかいはじめた。

ダサくてすみません。

今回は、そんななかで少し書き方でエラーになったところとかシンプルにメモするだけです。

出会ったエラー

  /your-object/{id}:  ## ←これがずっとエラーになってた
get:
tags:
- your-object
summary: to find your-object by id
responses:
200:
description: Successfull
400:
description: Not Found

エラー文

Declared path parameter “id” needs to be defined as a path parameter at either the path or operation level

とりあえずPathパラメーターまたはオペレーションレベルで定義ちゃんとしろボケ！とSwaggerさんに怒られている様子。

解決策

問題解決方法としてはここを参照して解決した。

  /your-object/{id}:
get:
tags:
- your-object
summary: to find your-object by id
parameters:   ## ←ここから
- in: path
name: id
type: integer
required: true　## ←ここまで追記した
responses:
200:
description: Successfull
400:
description: Not Found