创建密码重置令牌

版本 4.0.23.4

创建密码重置令牌。

这将为用户创建一个加密的安全随机密码重置令牌。 如果用户已有密码重置令牌，则旧令牌会失效并创建新令牌。 该令牌表示为用户的电子邮件地址/密码凭据对象的“password_reset_url”。此参数是一个可选的“expires”参数，用于指示新令牌是否应该是即将过期的令牌。 过期的令牌通常用于现有用户的自助密码重置。向新用户发送的邀请电子邮件通常不会过期。 启用有效期后，有效期始终为 60 分钟。 可使用空正文调用此方法。

请求

POST /users/{user_id}/credentials_email/password_reset
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
user_id
字符串
用户的 ID
查询
HTTPQuery
展开 HTTPQuery 定义...
到期时间
布尔值
令牌即将过期。
字段
字符串
请求的字段。

响应

200：电子邮件地址/密码凭据

数据类型
说明
（对象）
可以
对象
当前用户可以对此对象执行的操作
创建时间
字符串
此凭据的创建时间戳
电子邮件
字符串
用于用户登录的电子邮件地址
forced_password_reset_at_next_login
布尔值
强制用户在下次登录时更改密码
user_id
字符串
用户的唯一 ID
已停用
布尔值
此凭据已停用？
登录
字符串
最近使用凭据登录的时间戳
密码重置网址
字符串
包含可供用户用来重置密码的密码的一次性密码的网址
帐号设置网址
字符串
包含一次性密文的网址，用户可通过该令牌设置帐号
类型
字符串
此类凭据类型的简称
网址
字符串
用于获取此商品的链接
用户网址
字符串
用于获取此用户的链接

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

403：权限遭拒

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接