swagger-ui - 招摇: Add fields to all endpoints

Question

有没有办法将默认字段添加到我的所有端点？我希望将 api_key、sort、limit 等字段添加到我的所有端点。

能否在一个中心位置为所有端点添加一组默认输入参数？

Answer 1

您可以定义如下参数

"parameters": {
"skipParam": {
  "name": "skip",
  "in": "query",
  "description": "number of items to skip",
  "required": true,
  "type": "integer",
  "format": "int32"
},

然后像这样使用它

 "parameters": [
      { "$ref": "#/parameters/skipParam" }
],

使用它，您将不必一次又一次地指定参数详细信息，但需要在需要的地方添加 ref。

更多详细信息，请访问 Open Api Specification