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

İlgili makaleler

← Kimlik Doğrulama