外部与内部OpenAPI / Swagger定义

时间:2019-08-05 10:58:43

标签: swagger openapi

我正在编写一个API,该API在内部分为两个服务:

  • 身份验证服务,用于对用户进行身份验证并将标头注入请求(特别是用户所属的组列表);
  • 主要API服务,该服务使用上述标头进行授权(根据您的组,可以使用不同的端点)

这意味着我要显示给客户端的API定义与我在API服务上使用的定义不同-后者没有身份验证,但是需要额外的标头,这些标头不应从客户端发送(如果它们是的,它们仍然会被覆盖)。

是否可以从单个OpenAPI / Swagger定义文件中描述两个API定义?

我意识到我可以自己预处理一个主文件以生成两个OpenAPI定义-我想知道是否有可能没有额外的步骤。

0 个答案:

没有答案