在描述apigee127的swagger中的参数时，“查询”意味着什么？

Question

我刚开始使用API，最近我安装了Apige127来使用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将接受一个名称查询参数。

关于更多细节，您可以参考YAML规范-

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

和/或

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

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