POST/api/auth/sso/exchange
Bir 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.
Kimlik sağlayıcıda oturum açtıktan sonra Zentor App, tarayıcıyı `sso_code` sorgu parametresindeki tek seferlik bir kodla geri yönlendirir. Bu kodu `code` alanında gönderin. Yanıt, normal bir oturum açmadaki gibi `token` ve `refreshToken` içerir. Her kod yalnızca bir kez ve kısa bir süre için geçerlidir. Zaten kullanılmış, süresi dolmuş veya geçersiz bir kod 400 `SSO_EXCHANGE_INVALID` ile sonuçlanır; kullanıcı daha sonra SSO ile oturum açmayı yeniden başlatır. Bu nedenle çağrı idempotent değildir.
Genel Bakış
Çağrı: POST /api/auth/sso/exchange. 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: code (Body). Belgelenmiş hata durumları: 400 SSO_EXCHANGE_INVALID. 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
code(body, string, zorunlu)— SSO yönlendirmesinden tek seferlik kodÖrnek İstek
{"code":"<SSO geri arama yönlendirmesinden gelen tek kullanımlık kod>"}Örnek Yanıt
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Hata Kodları
400 SSO_EXCHANGE_INVALID — Kod geçersiz, zaten kullanılmış veya süresi dolmuş.Doğrulanmış davranış
Geçersiz bir kod 400 `SSO_EXCHANGE_INVALID` döndürür. Başarı durumu, kurulan kimlik sağlayıcıda eksiksiz bir oturum açmayı gerektirir.
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/reset-passwordSıfırlama e-postasındaki sıfırlama belirteciyle yeni bir parola ayarlar.