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}`)按照文件說明嘅流程嚟描述。