如何处理Swagger YAML中的重复请求参数

huangapple go评论59阅读模式
英文:

How to handle reoccurring request parameters in swagger yaml

问题

有没有一种方法可以像我们在模式中做的那样,在一个地方定义所有重复的请求参数。例如:

参数:

  • name: auth
    in: header
    description: 一个授权头部
    required: true
    type: string
  • name: id
    in: header
    description: 一个特殊的ID
    required: true
    type: string

这些标头在所有API中都是必需的,请告诉我是否有这样一种方法,以便我们不必在所有API中编写它们。谢谢。

英文:

Is there a way to define all the reoccurring request parameters in one place as we do with schemas. For example

parameters:
- name: auth
  in: header
  description: an authorization header
  required: true
  type: string
- name: id
  in: header
  description: an special id
  required: true
  type: string

These headers are required in all APIs so please let me know if there's such a way so we don't have to write them in all the APIs. Thanks.

答案1

得分: 1

你正在寻找$ref关键字

英文:

You are looking for the $ref keyword.

huangapple
  • 本文由 发表于 2023年5月17日 18:24:39
  • 转载请务必保留本文链接:https://go.coder-hub.com/76271080.html
匿名

发表评论

匿名网友

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

确定