/mfa/totp/devices
为用户注册一个新的TOTP设备，生成独立的密钥和二维码，支持多设备管理。参考：RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
请求体
Schema： service-mfa/internal/handler/dto.TOTPDeviceRegisterRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
device_name |
string |
是 | iPhone 15 |
||
account |
string |
否 | user@example.com |
||
device_fingerprint |
string |
否 | fp-abc123 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 201 | 设备注册成功 | service-mfa/internal/handler/dto.TOTPDeviceRegisterDetailResponse |
| 400 | 参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | service-core/base/dto.SimpleResponse |
| 409 | 设备数量已达上限 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.TOTPDeviceRegisterDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.TOTPDeviceRegisterResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.TOTPDeviceRegisterResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
device_id |
string |
否 | dev-abc123 |
||
device_name |
string |
否 | iPhone 15 |
||
qr_code |
string |
否 | data:image/png;base64,... |
||
qr_code_url |
string |
否 | otpauth://totp/... |
||
secret |
string |
否 | JBSWY3DPEHPK3PXP |