POST/api/auth/reset-password

Nastavi novo geslo z žetonom za ponastavitev iz e-pošte.

Pošljite `token` (iz povezave v e-pošti za ponastavitev) in novo `password` v telesu JSON. Prijava za to ni potrebna. Geslo mora izpolnjevati minimalne zahteve Zentor App. Ob uspehu strežnik odgovori s `{"ok":true}`; nato se uporabnik prijavi z novim geslom. Neveljaven, potekel ali že uporabljen žeton ter geslo, ki ne izpolnjuje minimalnih zahtev, povzročita 400 `VALIDATION_ERROR`. Žeton je porabljen po uspešni uporabi; za nadaljnjo spremembo začnite nov postopek prek `POST /api/auth/forgot-password`. Končna točka je omejena na 10 zahtev na 15 minut na IP-naslov. Žeton in geslo prenašajte samo v telesu zahteve prek HTTPS, nikoli kot parametre URL.

Pregled

Klic: POST /api/auth/reset-password. Ta endpoint spada v skupino »Avtentikacija« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: token (body), password (body). Dokumentirani primeri napak: 400 VALIDATION_ERROR. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Idempotentno: Ne

Parametri

token(body, string, obvezno)— Žeton za ponastavitev iz e-pošte
password(body, string, obvezno)— Novo geslo

Primer zahteve

{"token":"<Žeton iz e-pošte za ponastavitev>","password":"NovoVarnoGeslo!"}

Primer odgovora

{"ok":true}

Kode napak

400 VALIDATION_ERROR — Žeton je neveljaven, potekel ali že uporabljen, ali geslo ne izpolnjuje minimalnih zahtev.

Preverjeno vedenje

Neveljaven žeton vrne 400 `VALIDATION_ERROR`. Primer uspeha (200 `{"ok":true}`) je opisan na podlagi dokumentiranega postopka.

Avtentikacija

Sorodni članki

← Avtentikacija