- Authing 开放 API
- 认证 API
- 管理 API
- 获取 Token
- 权限管理
- 管理分组
- 审计日志
- 资源管理
- 管理应用
- 管理用户
- 管理注册白名单
- 管理组织机构
- 管理角色
- 管理策略
- 个人中心
- 用户池管理
- 账号绑定
- 身份源
- 租户
- 租户成员
检验二次验证 MFA 恢复代码
POST
/api/v2/mfa/totp/recovery
MFA 恢复代码获取方式：个人中心- MFA 绑定，恢复代码就是「步骤 4」的密钥
注意：恢复代码只能用一次，每次使用后当前接口会返回一个新的 recoveryCode ，请注意保存一下
请求参数
Header 参数
x-authing-userpool-id
string
用户池 ID
示例值:
59f86b4832eb28071bdd9214
Authorization
string
必需
示例值:
token
Body 参数application/json
recoveryCode
string
MFA 恢复代码
示例
{
"recoveryCode": "2486-225a-76f0-85a6-7268-c2d6"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://core.authing.cn/api/v2/mfa/totp/recovery' \
--header 'x-authing-userpool-id: 59f86b4832eb28071bdd9214' \
--header 'Authorization: token' \
--header 'Content-Type: application/json' \
--data-raw '{
"recoveryCode": "2486-225a-76f0-85a6-7268-c2d6"
}'返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
必需
data
object
必需
thirdPartyIdentity
object
必需
id
string
必需
createdAt
string
必需
updatedAt
string
必需
userPoolId
string
必需
isRoot
boolean
必需
status
string
必需
oauth
null
必需
email
string
必需
phone
null
必需
username
string
必需
unionid
null
必需
openid
null
必需
nickname
null
必需
company
null
必需
photo
string
必需
browser
null
必需
device
null
必需
password
string
必需
salt
string
必需
loginsCount
integer
必需
lastIp
string
必需
name
string
必需
givenName
null
必需
familyName
null
必需
middleName
null
必需
profile
null
必需
preferredUsername
null
必需
website
null
必需
gender
string
必需
birthdate
null
必需
zoneinfo
null
必需
locale
null
必需
address
null
必需
formatted
null
必需
streetAddress
null
必需
locality
null
必需
region
null
必需
postalCode
null
必需
city
null
必需
province
null
必需
country
null
必需
registerSource
array[string]
必需
secretInfo
null
必需
emailVerified
boolean
必需
phoneVerified
boolean
必需
lastLogin
string
必需
blocked
boolean
必需
isDeleted
boolean
必需
sendSmsCount
integer
必需
sendSmsLimitCount
integer
必需
encryptedPassword
string
必需
signedUp
string
必需
externalId
null
必需
mainDepartmentId
string
必需
mainDepartmentCode
null
必需
lastMfaTime
string
必需
passwordSecurityLevel
integer
必需
resetPasswordOnFirstLogin
boolean
必需
syncExtInfo
null
必需
phoneCountryCode
null
必需
secondaryUserIds
null
必需
lastIP
string
必需
token
string
必需
tokenExpiredAt
string
必需
identities
array[string]
必需
customData
object
必需
positions
array[string]
必需
recoveryCode
string
必需
recoveryCode
string
必需
示例
{
"code": 200,
"message": "二次验证成功",
"data": {
"thirdPartyIdentity": {
"provider": null,
"refreshToken": null,
"accessToken": null,
"scope": null,
"expiresIn": null,
"updatedAt": null
},
"id": "5a597f35085a2000144a10ed",
"createdAt": "2021-09-08T02:30:36.194Z",
"updatedAt": "2022-01-18T09:52:46.769Z",
"userPoolId": "59f86b4832eb28071bdd9214",
"isRoot": true,
"status": "Activated",
"oauth": null,
"email": "root@authing.cn",
"phone": null,
"username": "root",
"unionid": null,
"openid": null,
"nickname": null,
"company": null,
"photo": "https://files.authing.co/authing-console/default-user-avatar.png",
"browser": null,
"device": null,
"password": "423f44e5bccef5f18f87c9be05433b56",
"salt": "eZHMHdBGOESdsOI8jCDcCGVZMA8qay",
"loginsCount": 26,
"lastIp": "::1",
"name": "xiaoliu",
"givenName": null,
"familyName": null,
"middleName": null,
"profile": null,
"preferredUsername": null,
"website": null,
"gender": "U",
"birthdate": null,
"zoneinfo": null,
"locale": null,
"address": null,
"formatted": null,
"streetAddress": null,
"locality": null,
"region": null,
"postalCode": null,
"city": null,
"province": null,
"country": null,
"registerSource": [
"offcial:import"
],
"secretInfo": null,
"emailVerified": true,
"phoneVerified": false,
"lastLogin": "2022-01-18T09:52:46.754Z",
"blocked": false,
"isDeleted": false,
"sendSmsCount": 0,
"sendSmsLimitCount": 1000,
"encryptedPassword": "lpnEUNoSCEcNcnxvvZ5iqY+Y2CPa0NH2vseGSpy/n6Pu71nmQshm09kPdqAzvreYwpMo9f/Hwd3WdhcbCJb/N2C7ekWtnvhByvaxb0Aze8NSpQgtuAWvTVIFLy2aWual0JjY+SbnjNooCWFfuj34yXstX1aEjZ8XHjhADyZEs4o=",
"signedUp": "2021-09-08T02:30:36.194Z",
"externalId": null,
"mainDepartmentId": "613ef1902ee49ba1303159f6",
"mainDepartmentCode": null,
"lastMfaTime": "2022-01-18T09:51:17.917Z",
"passwordSecurityLevel": 1,
"resetPasswordOnFirstLogin": false,
"syncExtInfo": null,
"phoneCountryCode": null,
"secondaryUserIds": null,
"lastIP": "::1",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cGRhdGVkX2F0IjoiMjAyMi0wMS0xOFQwOTo1MToxNy45MzBaIiwiYWRkcmVzcyI6eyJjb3VudHJ5IjpudWxsLCJwb3N0YWxfY29kZSI6bnVsbCwicmVnaW9uIjpudWxsLCJmb3JtYXR0ZWQiOm51bGx9LCJwaG9uZV9udW1iZXJfdmVyaWZpZWQiOmZhbHNlLCJwaG9uZV9udW1iZXIiOm51bGwsImxvY2FsZSI6bnVsbCwiem9uZWluZm8iOm51bGwsImJpcnRoZGF0ZSI6bnVsbCwiZ2VuZGVyIjoiVSIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJlbWFpbCI6InJvb3RAYXV0aGluZy5jbiIsIndlYnNpdGUiOm51bGwsInBpY3R1cmUiOiJodHRwczovL2ZpbGVzLmF1dGhpbmcuY28vYXV0aGluZy1jb25zb2xlL2RlZmF1bHQtdXNlci1hdmF0YXIucG5nIiwicHJvZmlsZSI6bnVsbCwicHJlZmVycmVkX3VzZXJuYW1lIjpudWxsLCJuaWNrbmFtZSI6bnVsbCwibWlkZGxlX25hbWUiOm51bGwsImZhbWlseV9uYW1lIjpudWxsLCJnaXZlbl9uYW1lIjpudWxsLCJuYW1lIjoieGlhb2xpdSIsInN1YiI6IjVhNTk3ZjM1MDg1YTIwMDAxNDRhMTBlZCIsImV4dGVybmFsX2lkIjpudWxsLCJ1bmlvbmlkIjpudWxsLCJ1c2VybmFtZSI6InJvb3QiLCJkYXRhIjp7InR5cGUiOiJ1c2VyIiwidXNlclBvb2xJZCI6IjU5Zjg2YjQ4MzJlYjI4MDcxYmRkOTIxNCIsImFwcElkIjoiNjEzODIwNGMxOTRmMjc1OTlhMTYzZGE3IiwiaWQiOiI1YTU5N2YzNTA4NWEyMDAwMTQ0YTEwZWQiLCJ1c2VySWQiOiI1YTU5N2YzNTA4NWEyMDAwMTQ0YTEwZWQiLCJfaWQiOiI1YTU5N2YzNTA4NWEyMDAwMTQ0YTEwZWQiLCJwaG9uZSI6bnVsbCwiZW1haWwiOiJyb290QGF1dGhpbmcuY24iLCJ1c2VybmFtZSI6InJvb3QiLCJ1bmlvbmlkIjpudWxsLCJvcGVuaWQiOm51bGwsImNsaWVudElkIjoiNTlmODZiNDgzMmViMjgwNzFiZGQ5MjE0In0sInVzZXJwb29sX2lkIjoiNTlmODZiNDgzMmViMjgwNzFiZGQ5MjE0IiwiYXVkIjoiNjEzODIwNGMxOTRmMjc1OTlhMTYzZGE3IiwiZXhwIjoxNjQzNzA5MTY2LCJpYXQiOjE2NDI0OTk1NjYsImlzcyI6Imh0dHA6Ly9jb25zb2xlLmF1dGhpbmcubG9jYWxob3N0OjMwMDAvb2lkYyJ9.WW39GzoxqghycWIoZyKwHhGUyiRCCM_4DhbvrDANXnw",
"tokenExpiredAt": "2022-02-01T09:52:46.742Z",
"identities": [],
"customData": {
"cip": "erre"
},
"positions": [],
"recoveryCode": "2486-225a-76f0-85a6-7268-c2d6"
},
"recoveryCode": "ed9d-b24d-6532-29e1-164a-b111"
}修改于 2022-01-18 10:46:45