POST/api/auth/refresh
Geçerli bir yenileme belirtecini (refresh token) yeni bir erişim belirteci ve yenileme belirteci çiftiyle değiştirir.
JSON gövdesinde en son alınan `refreshToken`'ı gönderin. Yanıt yeni bir `token` ve yeni bir `refreshToken` içerir. Her yenileme belirteci yalnızca bir kez kullanılabilir ve varsayılan olarak yedi gün geçerlidir; her çağrıdan sonra yeni belirteci saklayın ve eskisini atın. Eksik, geçersiz, süresi dolmuş veya zaten kullanılmış bir yenileme belirteci 400 `VALIDATION_ERROR` ile sonuçlanır. Kullanıcı daha sonra `POST /api/auth/login` üzerinden yeniden oturum açmalıdır. Bir yenileme belirteci kullanıldığında tüketildiği için, bir istemci paralel yenilemelerden kaçınmalıdır.
Genel Bakış
Çağrı: POST /api/auth/refresh. 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: refreshToken (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
refreshToken(body, string, zorunlu)— En son verilen yenileme belirteciÖrnek İstek
{"refreshToken":"<Yenileme jetonu, /login üzerinden>"}Örnek Yanıt
{"ok":true,"token":"<yeni JWT>","refreshToken":"<yeni yenileme jetonu>"}Hata Kodları
400 VALIDATION_ERROR — Yenileme belirteci eksik, geçersiz, süresi dolmuş veya zaten kullanılmış.Doğrulanmış davranış
Geçerli bir yenileme belirteci yeni bir belirteç çifti döndürür; geçersiz bir belirteç 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/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/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.