POST /mfa/devices/sync
上传设备TOTP配置数据，加密存储并返回同步令牌。参考：RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
多因素认证 `bearerAuth` application/json
请求体
Schema： service-mfa/internal/handler/dto.DeviceSyncRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
device_name |
string |
是 |
iPhone 15 |
|
|
device_fingerprint |
string |
否 |
fp-abc123 |
|
|
scheme |
string |
否 |
e2ee_v1 |
|
|
totp_devices |
string |
否 |
v2:c2FsdA==:aXY=:Y2lwaGVy |
|
TOTPDevices 仅接受 v2 端到端加密信封（`v2:<base64 salt>:<base64 iv>:<base64 ciphertext>`，≤64KiB）；
明文一律不落库（按 metadata_v1 处理）。 |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
code |
integer |
否 |
|
|
|
message |
string |
否 |
|
|
|
timestamp |
string |
否 |
|
|
|
service-mfa/internal/handler/dto.DeviceSyncDetailResponse
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 密文；旧行一律为空（不回传、不解密）。 |
