GET `/mfa/devices/sync`

列出用户登记的设备；仅 e2ee_v1 回传密文，历史行不再解密（needs_resync）。

多因素认证 `bearerAuth` application/json

响应

状态	描述	Schema
200	设备同步列表	`service-mfa/internal/handler/dto.DeviceSyncListResponse`
400	参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 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.DeviceSyncListResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`items`	array of 参见 `service-mfa/internal/handler/dto.DeviceSyncResponse`	否			统一使用 items
`message`	`string`	否
`pagination`	`object`	否			分页信息（嵌套对象）
`timestamp`	`string`	否
`total`	`integer`	否			总条数（平铺，便于直接读取）

service-mfa/internal/handler/dto.DeviceSyncResponse

字段	类型	必填	示例	约束	描述
`created_at`	`string`	否	`2026-05-21T12:00:00Z`
`device_fingerprint`	`string`	否	`fp-abc123`
`device_name`	`string`	否	`iPhone 15`
`id`	`string`	否	`devsync_abc123`
`last_sync_at`	`string`	否	`2026-05-21T12:00:00Z`
`needs_resync`	`boolean`	否			NeedsResync 历史行（服务端可解密形态）已停止回传，客户端需重新同步。
`payload_dropped`	`boolean`	否			PayloadDropped 旧客户端明文载荷已被丢弃（不落库）；仅同步响应返回。
`scheme`	`string`	否	`metadata_v1`
`totp_devices`	`string`	否	`v2:c2FsdA==:aXY=:Y2lwaGVy`		TOTPDevices 仅回传 e2ee_v1 密文；旧行一律为空（不回传、不解密）。

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓