Swagger: Добавить поля ко всем конечным точкам

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" } 
], 

Используя это, вы не должны указывать детали параметров снова и снова, но нужно будет добавить реф, где требуется ,

Более подробную информацию можно найти по адресу: Open Api Specification