POST/api/auth/forgot-password
Bir 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.
`email` alanında hesabın e-posta adresini gönderin. `{"ok":true}` yanıtı kasıtlı olarak her zaman aynıdır – bir hesabın var olup olmadığından bağımsız olarak – böylece bu uç nokta üzerinden hangi adreslerin kayıtlı olduğu belirlenemez. Yeni parola daha sonra e-postadaki belirteçle `POST /api/auth/reset-password` üzerinden ayarlanır. `email` alanı eksik veya boşsa, uç nokta 400 `VALIDATION_ERROR` ile yanıt verir. Kötüye kullanıma karşı korumak için IP adresi başına istek sayısı sınırlıdır (429 `RATE_LIMIT_EXCEEDED`).
Genel Bakış
Çağrı: POST /api/auth/forgot-password. Bu uç nokta, Zentor App API'sinin “Kimlik Doğrulama” grubuna aittir. Herkese açıktır ve kimlik doğrulama gerektirmez. Çağrı idempotenttir: Aynı bilgilerle tekrarlanan çağrılar aynı sonucu döndürür. Zorunlu parametreler: email (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: Evet
Parametreler
email(body, string, zorunlu)— Hesabın e-posta adresiÖrnek İstek
{"email":"user@example.com"}Örnek Yanıt
{"ok":true}Hata Kodları
400 VALIDATION_ERROR — `email` alanı eksik veya boş.Doğrulanmış davranış
Hesabın var olup olmadığından bağımsız olarak yanıt 200 `{"ok":true}`'dur; eksik bir e-posta alanı 400 `VALIDATION_ERROR` döndürü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/reset-passwordSıfırlama e-postasındaki sıfırlama belirteciyle yeni bir parola ayarlar.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.