Swagger UI 是否有路径的永久链接？

Question

是否可以 link 到 Swagger UI 中显示的特定路径，例如下图中的 /work/2.1？

我想link从外部网页到个别路径。

Answer 1

是的，Swagger UI 有 permalinks 用于操作和标签。要获得永久链接，请展开操作或标记并复制地址栏中的 URL。永久链接如下所示：

index.html#/tagName
index.html#/tagName/operationId

当有人在浏览器中打开这样的永久链接时，相应的标签或操作会自动展开，并在需要时滚动到顶部。示例：
https://petstore.swagger.io/#/store/getInventory

在 Swagger 中 UI 2.2 永久链接默认启用。

如果使用UI3.x，需要3.0.19以上版本，需要在Swagger UI初始化代码中添加deepLinking: true index.html:

const ui = SwaggerUIBundle({
  url: "http://petstore.swagger.io/v2/swagger.json",
  deepLinking: true,  // <------

Answer 2

为 SwaggerUI 添加了深度 Link 支持：

app.UseSwaggerUI(c =>
{
    ...
    c.EnableDeepLinking();
});