Skip to content

Complete Login & Signup api to handle user auth, consumed by user-login-signup app

Notifications You must be signed in to change notification settings

l00pinfinity/user-backend-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UserBackend API

REST API for authenticating users.

Initialize Database

INSERT INTO roles(name) VALUES('ROLE_ADMIN');
INSERT INTO roles(name) VALUES('ROLE_MODERATOR');
INSERT INTO roles(name) VALUES('ROLE_USER');

REST API

Below are the REST APIs for the example app.

Create account

Request

POST /api/signup

curl --location --request POST 'http://localhost:8080/api/signup' \--header 'Content-Type: application/json' \--data-raw '{"username":"ckb","email":"[email protected]","password":"tyugbjhn"}'

Successful Response

{
    "success": true,
    "message": "User registered successfully"
}

Failed Response

  1. Email already in use
{
    "success": false,
    "message": "Email is already in use"
}
  1. Username is already taken
{
    "success": false,
    "message": "Username is already taken"
}

Login to account

Request

POST /api/signin

curl --location --request POST 'http://localhost:8080/api/signin' \--header 'Content-Type: application/json' \--data-raw '{"usernameOrEmail":"ckb","password":"qwerty"}'

Response

{
    "accessToken": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJja2IiLCJpYXQiOjE2NzAyNDc1OTksImV4cCI6MTY3MDI0NzY4NX0.CwuhFGhu0S15q5xpXWHfFqj836fXh2W3z1r6RpmcPlEswe50XcfXVg9iLW6F_QDRnnyzxFNJdAoMnWKDmTrq7g",
    "tokenType": "Bearer",
    "expiresIn": 86400
}

Forgot password

Request

POST /api/[email protected]

curl --location --request POST 'http://localhost:8080/api/[email protected]' \--data-raw ''

Reset token is sent to the user via provided email if it exists.

Successful Response

{
    "success": true,
    "message": "We have sent a password reset token to [email protected]"
}

Failed Response

  1. No account with the Email Address
{
    "success": false,
    "message": "There is no account with an email address"
}

Reset password

Request

POST /api/reset?token=c52d4ed8-f4a2-41de-90ca-f97bc4a56e37

curl --location --request POST 'http://localhost:8080/api/reset?token=c52d4ed8-f4a2-41de-90ca-f97bc4a56e37' \--header 'Content-Type: application/json' \--data-raw '{"password":"qwerty"}'

Successful Response

{
    "success": true,
    "message": "Your password has been successfully reset."
}

Failed Response

  1. Invalid token
{
  "success": false,
  "message": "The password reset link is invalid."
}

Get User by Username

Request

POST /api/users/in/{username}

curl --location --request GET 'http://localhost:8080/api/users/in/{username}'

Successful Response

{
    "success": true,
    "message": "User with username available",
    "data": {
        "id": 1,
        "email": "[email protected]",
        "username": "ckb",
        "roles": [
            {
            "id": 1,
            "name": "ROLE_USER"
            }
        ]
    }
}

Failed Response

  1. No user with username provided
{
  "success": false,
  "message": "No account with username provided"
}

About

Complete Login & Signup api to handle user auth, consumed by user-login-signup app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages