servicestack - swagger - 权限注释？

Question

有什么方法可以记录请求所需的权限？如果我有这样的注释

[Authenticate]
[RequiredRole("Admin")]
[RequiredPermission("CanAccess")]
public object Delete(DeleteAppUser deleteUserRequest)
{
   // ....
}

在我的服务类或我的 RequestDTO 中

[Authenticate]
[RequiredRole("Admin")]
[Route("/appusers/{AppUserId}", "DELETE", Summary = "Delete an application user identified by its ID.")]
public class DeleteAppUser : IReturn<AppUserDto>
{
    // ....
}

我可以在 swagger-ui 文档中自动为我的 API 用户提供它，还是我必须在注释中编写它，例如:

[Route("/appusers/{AppUserId}", "DELETE", Summary = "Delete an application user identified by its ID.", Notes="Requires an authenticated session and membership in the Admin role.")]

Answer 1

No Swaggers UI 没有角色或权限的概念。此信息显示在 ServiceStack 的 /metadata pages 上但是要在 Swagger 的 UI 中显示它，您需要将它添加到 API 的文本描述中。