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

POST /mfa/totp/devices/{id}/disable

禁用指定的TOTP设备,切换Enabled状态为false。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。

MFA `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes 设备ID

Responses

StatusDescriptionSchema
200设备已禁用dto.TOTPDeviceItem
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
404设备未找到gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.TOTPDeviceItem

FieldTypeRequiredExampleConstraintsDescription
created_at string No 2026-05-12T12:00:00Z
device_id string No dev-abc123
device_name string No iPhone 15
enabled boolean No True
last_used_at string No 2026-05-12T12:00:00Z
verified boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No