swagger-ui - 在运行时更改 swagger-ui 服务器变量

Question

使用 openapi v3 配置，我有一个名为“主机名”的服务器变量，用于构建 url，例如:

...
servers:
- url: http://{hostname}/api
 variables:
  hostname:
   "default": "some default here"
....

在运行时，我希望能够更改“主机名”服务器变量。我在页面上找到了 UI 元素，

<input type="text" value="some default here" data-variable="hostname">

通过编辑输入字段更改变量工作正常，但通过 jQuery 更改输入字段不起作用，即使在设置值后触发“更改”事件时，扩展 api 部分之一时该值也会恢复。我还尝试触发 keyup/keydown 和 focusin/focusout 事件以更好地模拟用户如何更改字段。

是否有更 swagger-ui 方法来通过公开调用更改此值？我已经浏览了 window.ui 但它有点神秘。

Answer 1

I have an api.yaml file hosted on different IoT devices. Each device will have a different hostname based on its configuration. When the page is loaded I'm trying to use javascript to set the 'hostname' server variable to be window.location.hostname, for example via javascript.

您可以简单地指定一个相对服务器 url – 它将相对于 OpenAPI 定义文件的位置进行解析。

例如，如果你有

servers:
  - url: /api

API定义文件位于

http://foobar/spec/api.yaml

然后基地 url对于 API 调用将被解析为

http://foobar/api