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

İlgili makaleler

← Kimlik Doğrulama