POST/api/auth/reset-password

Sıfırlama e-postasındaki sıfırlama belirteciyle yeni bir parola ayarlar.

JSON gövdesinde `token`'ı (sıfırlama e-postasındaki bağlantıdan) ve yeni `password`'ü gönderin. Bunun için oturum açma gerekmez. Parola, Zentor App'in minimum gereksinimlerini karşılamalıdır. Başarılı olursa sunucu `{"ok":true}` ile yanıt verir; ardından kullanıcı yeni parolayla oturum açar. Geçersiz, süresi dolmuş veya zaten kullanılmış bir belirteç ile minimum gereksinimleri karşılamayan bir parola, 400 `VALIDATION_ERROR` ile sonuçlanır. Bir belirteç başarılı kullanımdan sonra tüketilir; başka bir değişiklik için `POST /api/auth/forgot-password` üzerinden yeni bir işlem başlatın. Uç nokta, IP adresi başına 15 dakikada 10 istekle sınırlıdır. Belirteci ve parolayı yalnızca HTTPS üzerinden istek gövdesinde iletin, asla URL parametresi olarak göndermeyin.

Genel Bakış

Çağrı: POST /api/auth/reset-password. Bu uç nokta, Zentor App API'sinin “Kimlik Doğrulama” grubuna aittir. Herkese açıktır ve kimlik doğrulama gerektirmez. Çağrı idempotent değildir: Her başarılı çağrı işlemi yeniden tetikler. Zorunlu parametreler: token (Body), password (Body). Belgelenmiş hata durumları: 400 VALIDATION_ERROR. Aşağıdaki örnek yanıt, JSON formatındaki başarılı bir yanıtın yapısını gösterir.

Kimlik Doğrulama ve Güvenlik

Kimlik doğrulama gerekmez

İdempotent: Hayır

Parametreler

token(body, string, zorunlu)— E-postadaki sıfırlama belirteci
password(body, string, zorunlu)— Yeni parola

Örnek İstek

{"token":"<Sıfırlama e-postasındaki jeton>","password":"YeniGuvenliSifreniz!"}

Örnek Yanıt

{"ok":true}

Hata Kodları

400 VALIDATION_ERROR — Belirteç geçersiz, süresi dolmuş veya zaten kullanılmış, ya da parola minimum gereksinimleri karşılamıyor.

Doğrulanmış davranış

Geçersiz bir belirteç 400 `VALIDATION_ERROR` döndürür. Başarı durumu (200 `{"ok":true}`) belgelenen akışa göre tanımlanmıştır.

Kimlik Doğrulama

İlgili makaleler

← Kimlik Doğrulama