В чем разница между in: path и in: query при описании параметров в OpenAPI?

Разница между in: path и in: query при описании параметров в OpenAPI заключается в месте расположения параметра. learn.openapis.org github.com

in: path используется для описания параметров, которые находятся в пределах конечной точки пути, перед строкой запроса. habr.com github.com Обычно такие параметры выделяются фигурными скобками {}. github.com Например, в URL /users/{id} параметр с конструкцией in: path описывает идентификатор пользователя. learn.openapis.org eazyapi-1.gitbook.io

in: query используется для описания параметров, которые находятся в строке запроса конечной точки, располагаются после знака вопроса (?). habr.com github.com Несколько таких параметров разделяются амперсандом (&). habr.com github.com Пример: в URL /users?id=1234 параметр с конструкцией in: query описывает идентификатор пользователя. learn.openapis.org