如何使用自己的swagger-ui和Liberty JSON生成的内容

Question

有一个内部Liberty swagger-ui，它对我来说很好，但实际上我们需要制作自己的招摇布局，我的意思是把我们的徽标和公司名称等等。

这是我们使用基本的swagger-ui 调用 https://localhost:9443/ibm/api/docs 时得到的结果

但是当我们使用浏览器网址并粘贴 https://localhost:9443/ibm/api/docs 时，我们获得了服务的json内容

这就是它与ibm liberty swagger-ui 的合作方式

这就是我们需要向客户展示的方式

Answer 1

目前无法改变内置Liberty Swagger UI的“外观和感觉”，但您可以投票选择增强请求：https://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe&CR_ID=87860

如果你想让你自己的Swagger UI完全独立于Liberty的用户界面，你仍然可以从/ ibm / api / docs中获取，就像你的第一个截图所示 - 你唯一缺少的是在Liberty上设置CORS支持实例，以便允许您的自定义Swagger UI调用它。

以下是在Liberty中设置CORS的文档：https://www.ibm.com/support/knowledgecenter/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_webcontainer_cors_config.html?cp=SSEQTP_8.5.5%2F1-8-1-1-21-1

链接中的主要样本：

<cors domain="/ibm/api/collective"
  allowedOrigins="https://alice.com:8090"
  allowedMethods="GET, DELETE, POST"
  allowedHeaders="accept, MyRequestHeader1"
  exposeHeaders="MyResponseHeader1"
  allowCredentials="true"
  maxAge="3600" />