A AuthMS API Wiki API Reference iam.tianv.com →

GET /mfa/devices/sync

列出用户所有的设备同步记录,返回解密后的TOTP设备数据。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。

MFA `bearerAuth` application/json

Responses

StatusDescriptionSchema
200设备同步列表dto.DeviceSyncListResponse
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.DeviceSyncListResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.DeviceSyncResponse

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

dto.DeviceSyncResponse

FieldTypeRequiredExampleConstraintsDescription
created_at string No 2026-05-21T12:00:00Z
device_fingerprint string No fp-abc123
device_name string No iPhone 15
id string No devsync_abc123
last_sync_at string No 2026-05-21T12:00:00Z
sync_token string No hex-sync-token
totp_devices string No [{"secret":"JBSWY3DPEHPK3PXP"}]

gitee_com_linmes_authms_base_dto.PageInfo

FieldTypeRequiredExampleConstraintsDescription
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

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No