GET /mfa/totp/devices

列出用户的所有TOTP设备,支持多设备管理。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。

多因素认证 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
user_id query string 是 用户ID

响应

引用的 Schema

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

service-core/base/dto.SimpleResponse

字段类型必填示例约束描述
code integer 否
message string 否
timestamp string 否

service-mfa/internal/handler/dto.TOTPDeviceItem

字段类型必填示例约束描述
created_at string 否 2026-05-12T12:00:00Z
device_id string 否 dev-abc123
device_name string 否 iPhone 15
enabled boolean 否 True
last_used_at string 否 2026-05-12T12:00:00Z
verified boolean 否 True

service-mfa/internal/handler/dto.TOTPDeviceListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-mfa/internal/handler/dto.TOTPDeviceItem

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)