docs: document refresh token rotation and update examples

This commit is contained in:
2026-01-08 06:28:48 +01:00
parent 9ceaf35fd9
commit 35ef42eb93

View File

@@ -52,7 +52,7 @@ type AuthTokensResponse struct {
type AuthTokensDetail struct { type AuthTokensDetail struct {
AccessToken string `json:"access_token" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."` AccessToken string `json:"access_token" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."`
RefreshToken string `json:"refresh_token" example:"f94d4ddc7d9b4fcb9d3a2c44c400b780"` RefreshToken string `json:"refresh_token" example:"f94d4ddc7d9b4fcb9d3a2c44c400b780c3e1f1a5c2b7d4e6a0b1c2d3e4f5a6b7"`
User AuthUserSummary `json:"user"` User AuthUserSummary `json:"user"`
} }
@@ -593,7 +593,7 @@ func (h *AuthHandler) Logout(w http.ResponseWriter, r *http.Request) {
} }
// @Summary Refresh access token // @Summary Refresh access token
// @Description Use a refresh token to get a new access token. This endpoint allows clients to obtain a new access token using a valid refresh token without requiring user credentials. // @Description Use a refresh token to get a new access token. The refresh token is rotated on success, and the previous refresh token becomes invalid.
// @Tags auth // @Tags auth
// @Accept json // @Accept json
// @Produce json // @Produce json