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":"SanOnCyunMatMaa!"}

回應範例

{"ok":true}

錯誤代碼

400 VALIDATION_ERROR — 權杖無效、已過期或者已經被使用,或者密碼未符合最低要求。

已驗證嘅行為

無效權杖會回傳 400 `VALIDATION_ERROR`。成功情況(200 `{"ok":true}`)按照文件說明嘅流程嚟描述。

身份驗證

相關文章

← 身份驗證