AuthController - adkuba/TL-backend GitHub Wiki

Endpoints

Sign in

Path

POST /api/auth/signin

Request Body

Login Request

Parameter Type Description
username String user's username or email
password String user's password

Response

HTTP Status Code Scenario
201 Ok user succesfully logged in
400 Bad Request bad credentials

Response is JwtResponse

Refresh token

Path

POST /api/auth/refreshToken

Requests refresh_token http only cookie!

Response

HTTP Status Code Scenario
201 Ok user succesfully refreshed jwt token
400 Bad Request bad cookie

Response is JwtResponse

Sign up

POST /api/auth/signup

Request Body

Signup Request

Parameter Type Description
username String user's username
fullName String user's full name
email String user's email
roles Set<String> user roles
recaptchaToken String token from Google Recaptcha
password String user's password

Response

HTTP Status Code Scenario
201 Ok user created
400 Bad Request other cases

Errors returned in:

Message response

{
    "message": "my error/succes message"
}

Logout

Path

POST /api/auth/logout

Requests refresh_token http only cookie!

Response

HTTP Status Code Scenario
201 Ok user logged out
400 Bad Request other cases

Reset Password

Sends email with special id in link to reset password.

Path

POST /api/auth/resetPassword

Request params

Parameter Type Description
email String user's email

Response

HTTP Status Code Scenario
201 Ok user logged out
400 Bad Request other cases

Reset Password Change

Changes password from sent email.

Path

POST /api/auth/resetPasswordChange

Request Body

Password Reset Request

Parameter Type Description
oldPassword String user's old password
newPassword String user's new password
token String user's jwt token

Response

HTTP Status Code Scenario
201 Ok user's password changed
400 Bad Request other cases

Sends email with password change confirmation.

⚠️ **GitHub.com Fallback** ⚠️