Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Authorization Service

...

Anchor
authenticateToken
authenticateToken

...

Deck of Cards
idbimAuthenticateToken
Card
defaulttrue
labelURL / Resource / JSON Structure
 Resource: authorize 

URLhttps://api-stage.bimplus.net/v2/authorize

JSON Structure

Name

Mandatory / Optional

Type

Description

user_id

mandatory

string

The email address of the user

password

mandatory

string

The user's password

client_id

optional

string

The identifier of the used client

application_id

optional

string

The id of the application

remember_meoptionalboolOption for saving the user's credentials
Card
labelHTTP Method
 POST
Card
labelDescription
 Authorizes a user and returns a token for further API calls.

Please, use the client_id from the request and regenerate the token (using the same API call with client_id as the additional parameter) for having the possibility to login multiple times at the same time. For more information, see here

Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
 "user_id" : "test@bimplus.net",
 "password" : "test"
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
{
"access_token": "9c1874a62c974dcfa75e0132c423a088",
"expires_in": 2591999,
"client_id": "9fd0bb9d-570b-4719-bfae-93e2f879c19a",
"token_type": "BimPlus"
}

...

Deck of Cards
idbimExpireToken
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: authorize

URLhttps://api-stage.bimplus.net/v2/authorize 

Card
labelHTTP Method
 DELETE
Card
labelDescription
 The specified token will expire immediately.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Content-Type: application/json

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK

Anchor
rememberMe
rememberMe

How remember me works
Deck of Cards
idbimRememberMe
Card
defaulttrue
labelURL / Resource / JSON Structure
 Resource: authorize 

URLhttps://api-stage.bimplus.net/v2/authorize

JSON Structure

Name

Mandatory / Optional

Type

Description

user_id

mandatory

string

The email address of the user

password

mandatory

string

The user's password

client_id

optional

string

The identifier of the used client

application_id

optional

string

The id of the application

remember_memandatoryboolSet it to true
Card
labelHTTP Method
 POST
Card
labelDescription
  Once the "remember_me" parameter is set to true, we will get 3 extra parameters in the json response (i.e remember_me_token)
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
 "user_id" : "test@bimplus.net",
 "password" : "test"
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
{
"access_token": "9c1874a62c974dcfa75e0132c423a088",
"expires_in": 2591999,
"client_id": "9fd0bb9d-570b-4719-bfae-93e2f879c19a",
"token_type": "BimPlus"
}