in:"query" 在描述 apigee127 的 swagger 参数时是什么意思?

What does in:"query" mean when describing parameters in swagger for apigee127?

我是制作 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 数据中是什么意思?请建议阅读哪些文档以更好地理解上述内容。

in : "query"指定参数'name'为查询参数。换句话说,给定的 API 将接受名称查询参数。

更多细节可以参考YAML规范-

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

和/或

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