GET /internal/mfa/totp/devices
内部获取用户TOTP设备列表,无需JWT认证,供其他服务(identity-service)调用。需要X-Tenant-ID和InternalAPIKey认证。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
多因素认证 None application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
user_id |
query |
string |
是 |
|
|
|
用户ID |
X-Tenant-ID |
header |
string |
是 |
|
|
|
租户ID |
引用的 Schema
service-core/base/dto.PageInfo
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
has_next |
boolean |
否 |
|
|
HasNext indicates whether there is a next page |
has_prev |
boolean |
否 |
|
|
HasPrev indicates whether there is a previous page |
page |
integer |
否 |
|
|
Page is the current page number (1-based) |
page_size |
integer |
否 |
|
|
PageSize is the number of items per page |
total |
integer |
否 |
|
|
Total is the total number of items across all pages |
total_pages |
integer |
否 |
|
|
TotalPages is the total number of pages |
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
code |
integer |
否 |
|
|
|
message |
string |
否 |
|
|
|
timestamp |
string |
否 |
|
|
|
service-mfa/internal/handler/dto.TOTPDeviceItem
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
created_at |
string |
否 |
2026-05-12T12:00:00Z |
|
|
device_id |
string |
否 |
dev-abc123 |
|
|
device_name |
string |
否 |
iPhone 15 |
|
|
enabled |
boolean |
否 |
True |
|
|
last_used_at |
string |
否 |
2026-05-12T12:00:00Z |
|
|
verified |
boolean |
否 |
True |
|
|
service-mfa/internal/handler/dto.TOTPDeviceListResponse