Что означает "запрос" при описании параметров в сваггере для apigee127?

Question

Я новичок в создании API, и недавно я установил apigee 127 для создания API с использованием Swagger. Но есть несколько вещей, которые я не понимаю. Я рассматривал пример, который выглядит следующим образом (относится к вопросу):

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/
http://swagger.io/specification/