yaml - 在 apigee127 的 swagger 中描述参数时，in:"query" 是什么意思？

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"指定参数“名称”是查询参数。换句话说，给定的 API 将接受名称查询参数。

有关更多详细信息，您可以参考 YAML 规范 -

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

与/或

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