POST /api/v1/user/login

Description

This endpoint facilitates user logins for existing accounts.

Users are required to input their username and password to gain access. If the user possesses the correct credentials and holds Administrator permissions (confirmed: True), a token will be generated.

    token = jwt.encode({
        'username': user['username'],
        'exp': datetime.datetime.now(datetime.UTC) + datetime.timedelta(hours=1)
    }, current_app.config['SECRET_KEY'], algorithm='HS256')

Body (form data)

This endpoint expects the following data to be provided in the request body:

• username: The username for the already existing account. (string)
• password: The password for the already existing account. (string)

Request

Response

The response will indicate the success or failure of the login process.

Success Response

{
    "code": "200",
    "status": "Success",
    "message": "User logged in successfully",
    'token': "ayJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNzE2NjU3MDg4fQ.zwwyASDHTwsP2OcxMmaKZTDRI02DapStIfPyLlZI3K4"
}

{
    "code": "400",
    "status": "Bad Request",
    "message": "Username and password form is required"
}

{
    "code": "404",
    "status": "Not Found",
    "message": "User not registered"
}

{
    "code": "401",
    "status": "Unauthorized",
    "message": "Incorrect password"
}

{
    "code": "403",
    "status": "Unauthorized",
    "message": "User not confirmed"
}