Authentication

Get Token

Endpoint:

POST api/v9/mapscale/auth/token

Description:

After successful authentication, the response will contain an access_token field. Use the access_token in the request header as follows:

Authentication: Bearer {access_token}

This token is required to access secured endpoints.

Token Grant Types:

Client Credentials (For floorplan-job operations):

{
  "client_id": "129f4a88-e3d5-468e-af0b-4bce1046213f",
  "client_secret": "3f282ff2-f899-4702-82b3-0a724aeb1c94",
  "grant_type": "client_credentials"
}

Password (For admin operations):

{
  "username": "your_mail@pointr.tech",
  "password": "your_strong_password",
  "grant_type": "password"
}

Notes:

• You can perform floor-plan job operations with Pointr Cloud Jwt Token.
• The expires_in field in the response indicates the token's expiration time in seconds.
• Once the token expires, you will need to either use a refresh token (if available) or authenticate again to obtain a new token.

* You can access the possible response codes you may encounter here.

---

Create User

Endpoint:

POST api/v9/mapscale/auth/users

Description:

Creates a new user. The first user is typically created through the seeder.

Validations

• Username is required.
• Password is required.

Request Body:

{
  "username": "your_mail@pointr.tech",
  "password": "your_strong_password"
}

Success Response:

{
  "message": "User created successfully."
}

* You can access the possible response codes you may encounter here.

---

Update User

Endpoint:

PUT api/v9/mapscale/auth/users/{userIdentifier}

Description:

Updates a user.

Validations

• Username is required.
• Password is required.
• UserIdentifier given from the url must be available.

Request Body:

{
  "username": "your_mail@pointr.tech",
  "password": "your_strong_password"
}

Success Response:

{
  "message": "User updated successfully."
}

* You can access the possible response codes you may encounter here.

---

Get Users

Endpoint:

GET api/v9/mapscale/auth/users

Description:

Get the user list.

Request Body:

[
    {
      "id": "c0d0d77e-9f14-4575-a0a5-e6ef69a882de",
      "username": "your_mail1@pointr.tech"
    },
    {
      "id": "c0d0d77e-9f14-4575-a0a5-e6ef69a882dc",
      "username": "your_mail2@pointr.tech"
    },
    {
      "id": "c0d0d77e-9f14-4575-a0a5-e6ef69a882df",
      "username": "your_mail3@pointr.tech"
    }
]

* You can access the possible response codes you may encounter here.