openapi - OpenAPI 3 是否允许重复的参数名称但在不同的位置（路径/查询/标题）？

Question

我不确定我是否正确理解了规范。例如，这表明唯一参数由其名称和位置的组合定义。

这是否意味着我可以同时拥有一个名为“hello”的路径参数、一个名为“hello”的查询参数和一个名为“hello”的标头？

标签： openapi

Answer 1

这是否意味着我可以同时拥有一个名为“hello”的路径参数、一个名为“hello”的查询参数和一个名为“hello”的标头？

是的 - 因为路径/查询/标头参数进入 HTTP 请求的不同部分。

GET /path/hello/subpath?hello=value  <-- path and query
Host: example.com
hello: 123                           <-- HTTP header