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 belirtecipassword(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
POST /api/auth/loginBir kullanıcıyı e-posta adresi veya kullanıcı adı ve parola ile oturum açtırır ve bir erişim belirteci (JWT) ile bir yenileme belirteci (refresh token) verir.POST /api/auth/refreshGeçerli bir yenileme belirtecini (refresh token) yeni bir erişim belirteci ve yenileme belirteci çiftiyle değiştirir.POST /api/auth/forgot-passwordBir parolanın sıfırlanmasını başlatır: Belirtilen e-posta adresine sahip bir hesap varsa, sıfırlama için bir bağlantı içeren bir e-posta alır.POST /api/auth/sso/exchangeBir SSO oturum açmanın (SAML/OIDC) son adımı: yönlendirmeden gelen tek seferlik kodu bir erişim belirteci ve bir yenileme belirteciyle değiştirir.