Users - morenagit/wikiTest GitHub Wiki

Users

A user represents a web application user. This can be a parking company, municipality or municipal police employee.

User login

Description

Post user credentials to retrieve the authentication token.

  • Resource URI: /login
  • HTTP Req type: POST
  • Req Content Type: application/x-www-form-urlencoded
  • Res Content Type: application/json

Request Body

Parameter Type Description
email String User email
password String User password

Response Body

HTTP Res Code Structure Description
200 OK
  • Token
Returns the user’s authentication token
404 Not Found
  • Message
  • Code
Resource cannot be found

User registration

Description

Registers a new user

  • Resource URI: /users
  • HTTP Req type: POST
  • Req Content Type: application/x-www-form-urlencoded
  • Res Content Type: application/json

Request Body

Parameter Type Description
name String User name
surname String User surname
email String User email
role String User role:
  • Municipality
  • ParkingCompany
  • Police
company String User company (Only if user is a parking company employee)
password String User password

Response Body

HTTP Res Code Structure Description
200 OK
  • Token
  • Message
User has been successfully registered. Returns the user’s authentication token
422 Unprocessable Entity
  • Message
  • Code
User already exists

GET /users

Description

Sends bearer token to return user’s data.

  • Resource URI: /users
  • HTTP Req type: GET
  • Res Content Type: application/json

Response Body

HTTP Res Code Structure Description
200 OK
  • Content
  • Code
Returns user data
401 Unauthorized
  • Message
  • Code
Invalid or missing authorization token

Example

GET /users

{
    "company": null,
    "_id": "5dfe2a7fabe3ee3954e6935d",
    "name": "Morena",
    "surname": "Barboni",
    "email": "[email protected]",
    "username": "morena",
    "role": "Municipality",    
}
⚠️ **GitHub.com Fallback** ⚠️