NATSotp.mfa.factor-list列出用户 MFA 因素

返回用户绑定的 MFA 因素及状态。

Request Payload

消息格式:JSON

NameData TypeRequiredDescription
userIdstringYes用户 ID
type RequestBody = {
  /** 用户 ID */
  userId: string
}
{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C"
}

Response Payload

回复使用统一信封 {id, code, messages, result},其 result:

NameData TypeRequiredDescription
itemsarrayYesMFA 因素列表
type ResponseBody = {
  /** MFA 因素列表 */
  items: Record<string, unknown>[]
}
{
  "items": [
    {
      "factorId": "01JD8SKH4N5P8W4XO8S3WDI6T9B",
      "type": "totp",
      "status": "active",
      "createdAt": "2026-10-14T08:40:00Z"
    }
  ]
}

Response Code

回复使用统一信封 {id, code, messages, result},其 code 字段:

code Meaning Notes
0 成功 列出用户 MFA 因素

Examples

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