PUT `/mfa/sms/enroll`

为用户注册短信MFA认证方式。参考：OWASP ASVS V2.8。

多因素认证 `bearerAuth` application/json

请求体

Schema： service-mfa/internal/handler/dto.SMSEnrollRequest

字段	类型	必填	示例	约束	描述
`phone`	`string`	是	`+8613800138000`

响应

状态	描述	Schema
201	注册成功	`service-mfa/internal/handler/dto.SMSEnrollDetailResponse`
400	参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`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.SMSEnrollDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-mfa/internal/handler/dto.SMSEnrollResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-mfa/internal/handler/dto.SMSEnrollResponse

字段	类型	必填	示例	约束	描述
`enabled`	`boolean`	否	`False`
`method_type`	`string`	否	`sms`
`phone`	`string`	否	`+8613800****000`
`status`	`string`	否	`pending_verification`
`verified`	`boolean`	否	`False`

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