Re-usable 参数在开放 api 规范中

Question

我有一个采用 X-Request-ID header 的端点。这被描述为：

parameters:
    - in: header
      name: X-Request-ID
      schema:
        type: string
        format: uuid
      required: true

但是，如果我有 10 个端点接受这个 header，我是否必须继续重复这个，或者无论如何我可以获得一些 re-use？

谢谢

Answer 1

添加到 Helen 的评论中，您可以通过将 X-Request-ID 定义为 Parameter Object in the Parameters Definitions Object, then reference it (by using a Reference Object) in the parameters field of each Path Item Object 来实现一些重用，以表示它适用于路径下的所有操作。

Re-usable parameters in open api specification