Get Password Token


获取用于重置密码的 Token。

前提条件


应用需拥有“在本 OU 创建或删除用户账号”的权限。如有需要，联系 OU 管理员获取权限。

请求格式


POST https://{apigw-address}/app-portal-service/v2.3/password/getResetToken

请求参数（URI）


名称

位置（Path/Query）

必需/可选

数据类型

描述

orgId

Query

必需

String

用户所属的 OU ID。如何获取 orgId 信息 >>

请求参数（Body）


名称

必需/可选

数据类型

描述

userId

可选

String

需要重置密码的用户 ID。不可与 email 参数同时为空。如何获取用户 ID >>

email

可选

String

需要重置密码的用户的邮箱。不可与 userID 参数同时为空。

响应参数


名称

数据类型

描述

token

String

用于重置密码的 Token。

错误码


代码

描述

31400

缺少必要参数，或用户 ID 和邮箱不匹配。

31403

当前应用没有“在本 OU 创建或删除用户账号”的权限，无法获取重置密码的 token。

31404

OU 或用户不存在，用户不在本 OU，或本 OU 未获取此应用。

31429

重置密码次数已达上限。

示例

请求示例


url: https://{apigw-address}/app-portal-service/v2.3/password/getResetToken?orgId=your_org_ID
method: POST
{

  "userId": "your_user_id"

}

返回示例


{

  "code": 0,

  "message": "",

  "data": {

    "token": "your_token"

  }

}