GET `/mfa/totp/devices`

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

MFA `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`user_id`	`query`	`string`	Yes				用户ID

Responses

Status	Description	Schema
200	TOTP设备列表	`dto.TOTPDeviceListResponse`
400	参数错误	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	未认证	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	服务器内部错误	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.TOTPDeviceItem

Field	Type	Required	Example	Constraints	Description
`created_at`	`string`	No	`2026-05-12T12:00:00Z`
`device_id`	`string`	No	`dev-abc123`
`device_name`	`string`	No	`iPhone 15`
`enabled`	`boolean`	No	`True`
`last_used_at`	`string`	No	`2026-05-12T12:00:00Z`
`verified`	`boolean`	No	`True`

dto.TOTPDeviceListResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`items`	array of See `dto.TOTPDeviceItem`	No			统一使用 items
`message`	`string`	No
`pagination`	`object`	No			分页信息（嵌套对象）
`timestamp`	`string`	No
`total`	`integer`	No			总条数（平铺，便于直接读取）

gitee_com_linmes_authms_base_dto.PageInfo

Field	Type	Required	Example	Constraints	Description
`has_next`	`boolean`	No			HasNext indicates whether there is a next page
`has_prev`	`boolean`	No			HasPrev indicates whether there is a previous page
`page`	`integer`	No			Page is the current page number (1-based)
`page_size`	`integer`	No			PageSize is the number of items per page
`total`	`integer`	No			Total is the total number of items across all pages
`total_pages`	`integer`	No			TotalPages is the total number of pages

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑