NATSattempt.history.query检索用户尝试历史

分页返回用户全部登录尝试(成功与失败均留档),管理端使用。

Request Payload

消息格式:JSON

NameData TypeRequiredDescription
userIdstringYes用户 ID
statusstringNosatisfied / failed / abandoned
pagenumberNo页码,默认 1
pageSizenumberNo每页数量,默认 20,上限 100
type RequestBody = {
  /** 用户 ID */
  userId: string
  /** satisfied / failed / abandoned */
  status?: string
  /** 页码,默认 1 */
  page?: number
  /** 每页数量,默认 20,上限 100 */
  pageSize?: number
}
{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "status": "satisfied",
  "page": 1,
  "pageSize": 20
}

Response Payload

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

NameData TypeRequiredDescription
itemsarrayYes尝试列表
totalnumberYes总数
pagenumberYes当前页码
pageSizenumberYes每页数量
type ResponseBody = {
  /** 尝试列表 */
  items: Record<string, unknown>[]
  /** 总数 */
  total: number
  /** 当前页码 */
  page: number
  /** 每页数量 */
  pageSize: number
}
{
  "items": [
    {
      "attemptId": "01JD8ST4UZ9U2WL",
      "status": "satisfied",
      "verifiedFactors": [
        "password",
        "mfa"
      ],
      "score": 100,
      "ip": "203.0.113.24",
      "fingerprintHash": "fp_c41a9e07d2b8",
      "createdAt": "2026-10-14T08:00:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20
}

Response Code

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

code Meaning Notes
0 成功 检索用户尝试历史

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "status": "satisfied", "page": 1, "pageSize": 20 }
{
  "id": "01JD8SVSW4H0J7KG",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "attemptId": "01JD8ST4UZ9U2WL",
        "status": "satisfied",
        "verifiedFactors": ["password", "mfa"],
        "score": 100,
        "ip": "203.0.113.24",
        "fingerprintHash": "fp_c41a9e07d2b8",
        "createdAt": "2026-10-14T08:00:00Z"
      }
    ],
    "total": 42,
    "page": 1,
    "pageSize": 20
  }
}