yaml - in:"query" は、apigee127 の swagger でパラメータを記述するときに何を意味しますか?

Question

API の作成は初めてで、最近 apigee 127 をインストールして、swagger を使用して API を作成しました。しかし、私が理解していないことがいくつかあります。私は次のような例を経験していました(質問に関連):

parameters:
    -
      name: "name"
      in: "query"
      description: "The name of the person to whom to say hello"
      required: false
      type: "string"

何が

in: "query"

上記の YAML データの意味は? 上記をよりよく理解するためにどのドキュメントを読むべきかを親切に提案してください。

Answer 1

in : "query"パラメーター 'name' がクエリ パラメーターであることを指定します。つまり、指定された API は name クエリ パラメータを受け入れます。

詳細については、YAML 仕様を参照してください -

http://yaml.org/spec/1.2/spec.html

AND / OR

http://swagger.io/specification/#parameterObject
http://swagger.io/specification/#parameterIn