POST/api/auth/reset-password
使用密码重置邮件中的重置令牌设置新密码。
在 JSON 请求体中发送 `token`(来自重置邮件中的链接)和新的 `password`。无需登录即可完成。密码必须符合 Zentor App 的最低要求。成功时,服务器以 `{"ok":true}` 响应;之后用户使用新密码登录。 令牌无效、已过期或已被使用,或密码不符合最低要求,均会导致 400 `VALIDATION_ERROR`。令牌在成功使用后即失效;若需再次更改,请通过 `POST /api/auth/forgot-password` 重新发起流程。此端点限制为每个 IP 地址 15 分钟内 10 次请求。 请仅通过 HTTPS 在请求体中传输令牌和密码,切勿作为 URL 参数传输。
概览
调用:POST /api/auth/reset-password。该端点属于 Zentor App API 的“身份验证”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:token (请求体), password (请求体)。 已记录的错误情况:400 VALIDATION_ERROR。 下方的示例响应展示了 JSON 格式的成功响应结构。
身份验证与安全
无需身份验证
幂等: 否
参数
token(body, string,必填)— 来自电子邮件的重置令牌password(body, string,必填)— 要设置的新密码请求示例
{"token":"<来自重置邮件的 Token>","password":"XinDeAnQuanMiMa!"}响应示例
{"ok":true}错误代码
400 VALIDATION_ERROR — 令牌无效、已过期或已被使用,或密码不符合最低要求。已验证的行为
无效令牌返回 400 `VALIDATION_ERROR`。成功情况(200 `{"ok":true}`)依据文档说明的流程来描述。