Authentication

Authentication with email and password

POST https://api.tiledesk.com/v3/auth/signin

Allows to authenticate an agent using email and password.

Headers

• Content-Type (string) — use "application/json" value

Request Body

• email (string) — the user email address

• password (string) — the user password

200 Response example

{
   "success": true,
   "token": "JWT  XYZ",
   "user": {
      "_id": "5ab11c6b83dc240014d46095",
      "email": "[email protected]"
   }
}

---

Anonymous authentication for a user

POST https://api.tiledesk.com/v3/auth/signinAnonymously

Allows a user to authenticate anonymously on the system.

Headers

• Content-Type (string) — use "application/json" value

Request Body

• id_project (string) — the project to which the user belongs

• firstname (string) — the user firstname

• lastname (string) — the user lastname

• email (string) — the user email

• attributes (object) — the user custom attributes

200 Response example

{
   "success": true,
   "token": "JWT XYZ",
   "user": {
      "_id": "5e25944ecf6bcc00178e75fa",
      "email": "[email protected]",
      "emailverified": false,
      "createdAt": "2020-01-20T11:51:42.115Z",
      "updatedAt": "2020-01-20T11:51:42.115Z",
      "__v": 0
   }
}

---

Custom authentication for a user

POST https://api.tiledesk.com/v3/auth/signinWithCustomToken

Allows to authenticate with a custom JWT token.

Headers

• Authorization (string) — Custom JWT Authorization token.

200 Response example

{
   "success": true,
   "token": "JWT eyJ0eXYZ",
   "user": {
     "_id": "123456",
     "firstname": "Andrea",
     "lastname": "Leo",
     "email": "[email protected]",
     "code": "123456",
     "sub": "userexternal",
     "aud": "https://tiledesk.com/projects/5ec688ed13400f0012c2edd1",
     "iat": 1598865103,
     "exp": 1598865223
  }
}

Example curl request:

curl 'https://api.tiledesk.com/v3/auth/signinWithCustomToken' \
  -X 'POST' \
  -H 'authorization: JWT eyJ0eXAiOiJKVXYZZ....ZZZZZ'

You can find here: https://developer.tiledesk.com/apis/authentication

Last updated 1 year ago