/internal/mfa/sms/send
内部API。按 user_id 解析其已登记的 SMS MFA 设备并投递短信验证码,供 identity 登录期调用。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
X-Tenant-ID |
header |
string |
是 | 租户ID |
请求体
Schema: service-mfa/internal/handler/dto.InternalSMSSendRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
user_id |
string |
是 | |||
purpose |
string |
否 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 发送成功 | service-mfa/internal/handler/dto.SMSSendDetailResponse |
| 400 | 参数错误 / 未登记短信 MFA | service-core/base/dto.SimpleResponse |
| 401 | 未提供有效的X-API-Key | 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.SMSSendDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.SMSSendResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.SMSSendResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
expires |
string |
否 | 2026-05-25T12:05:00Z |
||
sent |
boolean |
否 | True |