Page History

...

Deck of Cards

id	bimCreateUser

Card

default	true
label	URL / Resource / JSON Structure

Resource: users

URL: https://api-stage.bimplus.net/v2/users

Example: https://api-stage.bimplus.net/v2/users

JSON Structure:

Name	Mandatory / Optional	Type	Description
email	mandatory	string	Email of the user
status	optional	will be ignored	The status of the account (Active / Disabled)
password	mandatory	string	Password of the user
firstname	optional	string	First name of the user
lastname	optional	string	Last name of the user
company	optional	string	Company of the user
displayname	optional	string	Display name of the user
info	optional	string	Information of the user
gender	optional	string	Gender of the user (values MR, MS)
phoneWork	optional	string	Office phone number of the user
phoneHome	optional	string	Home phone number of the user
fax	optional	string	Fax number of the user
mobile	optional	string	Mobile number of the user
birthDate	optional	string	Birth date of the user
~~address~~	~~optional~~	~~object~~	~~Address of the user~~
~~street~~	~~optional~~	~~string~~	~~Street name of the user~~
~~streetNr~~	~~optional~~	~~string~~	~~Street number of the user~~
~~zip~~	~~optional~~	~~string~~	~~Zip code~~
~~city~~	~~optional~~	~~string~~	~~City name of the user~~
preferedLanguage	optional	string	Preferred language of the user (will be set in the portal "en", "de", "fr", "ru", "it", "es", "cs", "tr", "us", "ro" )
teams	will be ignored	array	Team list of the user
team	will be ignored	object	Information about an user's team (See the team service)
photo	will be ignored	string	Download link for user's photo

Card

label	HTTP Method

POST

Card

label	Description

Creates a new user account. Please remember that this service can be used only by the shop/portal (secured using the application_id of portal)

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
 "email" : "test@bimplus.net",
 "password" : "test"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "teams": [],
    "id": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6",
    "email": "test@bimplus.net",
    "status": "Active",
    "firstname": "",
    "lastname": "",
    "company": "",
    "displayname": "",
    "info": "",
    "gender": "",
    "phoneWork": "",
    "phoneHome": "",
    "fax": "",
    "mobile": "",
    "birthDate": "",
    "address": {
        "street": "",
        "streetNr": "",
        "zip": "",
        "city": "",
        "country": ""
    },
    "preferedLanguage": ""
}

...

Deck of Cards

id	bimUpdateUserInfo

Card

default	true
label	URL / Resource / JSON Structure

Resource: users/<user_id>

URL: https://api-stage.bimplus.net/v2/users/<user_id>

Example: https://api-stage.bimplus.net/v2/users/b8615afc-99cc-4bcd-b0ca-ff0593ce15c6

JSON Structure:

Name	Mandatory / Optional	Type	Description
email	optional	string	Email of the user
status	optional	string	The status of the account (Active / Disabled)
password	optional	string	Password of the user
firstname	optional	string	First name of the user
lastname	optional	string	Last name of the user
company	optional	string	Company of the user
displayname	optional	string	Display name of the user
info	optional	string	Information of the user
gender	optional	string	Gender of the user
phoneWork	optional	string	Office phone number of the user
phoneHome	optional	string	Home phone number of the user
fax	optional	string	Fax number of the user
mobile	optional	string	Mobile number of the user
birthDate	optional	string	Birth date of the user
~~address~~	~~optional~~	~~object~~	~~Address of the user~~
~~street~~	~~optional~~	~~string~~	~~Street name of the user~~
~~streetNr~~	~~optional~~	~~string~~	~~Street number of the user~~
~~zip~~	~~optional~~	~~string~~	~~Zip code~~
~~city~~	~~optional~~	~~string~~	~~City name of the user~~
~~country~~	~~optional~~	~~string~~	~~Country name of the user~~
preferredLanguage	optional	string	Preferred language of the user (will be set in the portal)
teams	will be ignored	array	Team list of the user
team	will be ignored	object	Information about an user's team (See the team service)
hasAcceptedTerms	optional	bool	Accept terms and conditions

Card

label	HTTP Method

PUT

Card

label	Description

Update information about a specified user. Please remember that this service can be used only by the shop/portal (secured using the application_id of portal)

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "email": "updated_test@bimplus.net",
    "status": "Active",
    "password": "test"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

title	JSON

{
  "teams": [
    {
      "team": {
        "slug": "bimplus-demo",
        "name": "bimplus-demo",
        "displayname": "bimplus-demo",
        "owner": "e0837206-4bff-65d4-b79f-f3878c3567fd",
        "status": "Active",
        "teamWorksConnection": null,
        "dataStorageStatus": null,
        "ismyteam": false,
        "rights": null,
        "id": "ba790aa0-8631-410b-842f-1ee53349e0ae"
      }
    },
    {
      "team": {
        "slug": "test-company",
        "name": "Test Company",
        "displayname": "Test Company",
        "owner": "3d676814-cf37-aa43-ed03-4b156c282fa1",
        "status": "Active",
        "teamWorksConnection": null,
        "dataStorageStatus": null,
        "ismyteam": true,
        "rights": null,
        "id": "870ce403-9d5c-4e58-8684-9eb3e2fc8daf"
      }
    }    
  ],
  "id": "3d676814-cf37-aa43-ed03-4b156c282fa1",
  "email": "updated_test@bimplus.net",
  "status": "Active",
  "firstname": "Test",
  "lastname": "User",
  "company": "Allplan",
  "fullname": "Test User",
  "displayname": "Test User [Allplan]",
  "info": "",
  "gender": "MR",
  "phoneWork": "",
  "phoneHome": "",
  "fax": "",
  "mobile": "123",
  "birthDate": "",
  "address": {
    "street": "",
    "streetNr": "",
    "zip": "",
    "city": "",
    "country": ""
  },
  "preferedLanguage": "en"
}

...

Deck of Cards

id	bimForgotPassword

Card

default	true
label	URL / Resource / JSON Structure

Resource: auth-forgot

URL: https://api-stage.bimplus.net/v2/auth-forgot

Example: https://api-stage.bimplus.net/v2/auth-forgot

JSON Structure:

Name	Mandatory / Optional	Type	Description
user_id	mandatory	string(guid)	Recipient user_id (i.e the user who has triggered the forgot password action or the user who will be re-invited to join the team)
creator_user_id	optional	string(guid)	This will be used only for the re-send invitation case to identify the user who has sent the invitation.

Card

label	HTTP Method

POST

Card

label	Description

This API is used for two purposes. It can be used if the user has forgot the password(in this case, the creator_user_id parameter will be ignored) This API is also used for re-inviting an user to join his team/project where "creator_user_id" is the id of the user who sent the invitation. In both the cases, the recipient will get an email with the link(eg: <url>#/forgot_password?email=<email>&cross_token=xxx) which will take the user to "Forgot Password" page or to the "User Activation/Registration"(eg: <url>#/accept_invitation?email=<email>&cross_token=xxx) page. The validity of the cross-token is different on each case. For forgot password, the token is 1 day valid & for the invitation it is 1 week valid.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "user_id": "user@bimplus.net",
    "creator_user_id": "31cb1181-2cbc-49dc-883a-0620e20140a4"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "user_id": "user@bimplus.net",
    "creator_user_id": "31cb1181-2cbc-49dc-883a-0620e20140a4"
}

...

Deck of Cards

id	bimChangePassword

Card

default	true
label	URL / Resource / JSON Structure

Resource: change_password

URL: https://api-stage.bimplus.net/v2/change_password

Example: https://api-stage.bimplus.net/v2/change_password

JSON Structure:

Name	Mandatory / Optional	Type	Description
old	mandatory	string	Old password
new	mandatory	string	New password

Card

label	HTTP Method

PUT

Card

label	Description

This API is used for changing the password.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
"old": "old_pwd",
"new": "new_pwd"
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "user_id": "user@bimplus.net",
    "creator_user_id": "31cb1181-2cbc-49dc-883a-0620e20140a4"
}

...

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 26

New Version 27

Key