User Login API

User Login

Authenticate a user based on their roll number and password, and generate access tokens.

Request

• Method: POST
• Can be accessed by: Any registered user
• URL: /api/user/login
• Body:

  {
    "rollNumber": "123456",
    "password": "password"
  }

Response

• Status: 200 OK
• Body:

  {
    "success": true,
    "data": {
      "user": {
        "rollNumber": "123456",
        "name": "John Doe",
        "email": "john.doe@example.com"
      },
      "token": {
        "accessToken": "<access_token>",
        "refreshToken": "<refresh_token>"
      }
    },
    "error": null
  }

Error Responses

• Invalid Request Body

  • Status: 400 Bad Request
  • Body:

    {
      "success": false,
      "data": null,
      "error": "Invalid Request Body. Required fields: rollNumber, password"
    }

• User Not Found

  • Status: 404 Not Found
  • Body:

    {
      "success": false,
      "data": null,
      "error": "User does not exist"
    }

• Invalid Password

  • Status: 401 Unauthorized
  • Body:

    {
      "success": false,
      "data": null,
      "error": "Invalid Password"
    }