/mfa/totp/devices/{device_id}
撤销指定的TOTP设备，需要提供当前TOTP验证码进行验证。参考：RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
device_id |
path |
string |
是 | 设备ID |
请求体
Schema： service-mfa/internal/handler/dto.TOTPDeviceRevokeRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
string |
是 | 123456 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 设备已撤销 | service-mfa/internal/handler/dto.DisabledDetailResponse |
| 400 | 参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | service-core/base/dto.SimpleResponse |
| 404 | 设备未找到 | 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.DisabledDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.DisabledResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.DisabledResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
disabled |
boolean |
否 | True |