注册可信设备

POST

/${platform.component.mfa.management.api-prefix:/mfa}/trusted-devices

在用户完成 MFA 验证后，将当前设备注册为可信设备，以便后续登录可以跳过 MFA 验证。

API路径：POST /api/mfa/trusted-devices

请求参数

Header 参数

Body 参数application/json

示例

{
    "tenantId": "string",
    "userId": "string",
    "deviceId": "string",
    "deviceName": "string",
    "deviceFingerprint": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '/${platform.component.mfa.management.api-prefix:/mfa}/trusted-devices' \
--header 'Content-Type: application/json' \
--data '{
    "tenantId": "string",
    "userId": "string",
    "deviceId": "string",
    "deviceName": "string",
    "deviceFingerprint": "string"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
  "data": {
    "deviceId": "",
    "deviceName": "",
    "deviceType": "",
    "trustedUntil": "",
    "lastUsedTime": "",
    "createdAt": "",
    "isPrimary": false
  },
  "code": "",
  "msg": "",
  "i18nDict": {
    "": {
      "": ""
    }
  },
  "timestamp": 0
}

修改于 2026-02-03 14:05:35

查询MFA状态