GET/api/v1/mfa/factors列出我的 MFA 因素

Try it 面板需要启用 JavaScript。

返回当前用户绑定的全部 MFA 因素及其状态。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

Response

Body

Name	Data Type	Required	Description
items	array	Yes	MFA 因素列表

type ResponseBody = {
  /** MFA 因素列表 */
  items: Record<string, unknown>[]
}

{
  "items": [
    {
      "factorId": "01JD8SKH4N5P8W4XO8S3WDI6T9B",
      "type": "totp",
      "status": "active",
      "createdAt": "2026-10-14T08:40:00Z"
    }
  ]
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回因素列表

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回因素列表

Examples

GET /api/v1/mfa/factors
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SKIJ4N1M5L6",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "factorId": "01JD8SKH4N5P8W4XO8S3WDI6T9B",
        "type": "totp",
        "status": "active",
        "createdAt": "2026-10-14T08:40:00Z"
      }
    ]
  }
}