Page History

User Management Service

Anchor

	createUser
	createUser

Please remember that creating/updating/deleting an user is possible only for the clients who has the permission to do it.

Create a new user

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": ""
}

Anchor

	getUserInfo
	getUserInfo

Get information about the user

Deck of Cards

id	bimGetUserInfo

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

Card

label	HTTP Method

GET

Card

label	Description

Get information about a specified user.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

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

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
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": "testuser@allplan.com",
  "status": "Active",
  "firstname": "Test",
  "lastname": "User",
  "company": "Allplan",
  "fullname": "Test User",
  "displayname": "Test User [Allplan]",
  "info": "",
  "gender": "MR",
  "phoneWork": "",
  "phoneHome": "",
  "fax": "",
  "mobile": "",
  "birthDate": "",
  "address": {
    "street": "",
    "streetNr": "",
    "zip": "",
    "city": "",
    "country": ""
  },
  "preferedLanguage": "en"
}

Anchor

	updateUser
	updateUser

Update information about the user

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)

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": "0000-00-00",
  "address": {
    "street": "jarosova ",
    "streetNr": "1",
    "zip": "83102",
    "city": "Bratislava",
    "country": "8f241f1109647a265.29938154"
  },
  "preferedLanguage": "en"
}

Anchor
deleteUser
deleteUser

Delete the user

Deck of Cards

id	bimDeleteUser

Card

default	true
label	URL / Resource / JSON Structure

Resource: users

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

Example: https://api-stage.bimplus.net/v2/users/08b8195a-a2ad-11e2-9993-002215ea7d6b

Card

label	HTTP Method

DELETE

Card

label	Description

Delete 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

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Anchor

	getCurrentUserInfo
	getCurrentUserInfo

Get information about the currently logged in user

Deck of Cards

id	bimGetCurrentUserInfo

Card

default	true
label	URL / Resource / JSON Structure

Resource: user

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

Card

label	HTTP Method

GET

Card

label	Description

Get information about the currently logged in user.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

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

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
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": "testuser@allplan.com",
  "status": "Active",
  "firstname": "Test",
  "lastname": "User",
  "company": "Allplan",
  "fullname": "Test User",
  "displayname": "Test User [Allplan]",
  "info": "",
  "gender": "MR",
  "phoneWork": "",
  "phoneHome": "",
  "fax": "",
  "mobile": "123",
  "birthDate": "0000-00-00",
  "address": {
    "street": "jarosova ",
    "streetNr": "1",
    "zip": "83102",
    "city": "Bratislava",
    "country": "8f241f1109647a265.29938154"
  },
  "preferedLanguage": "en"
}

Anchor

	updateCurrentUser
	updateCurrentUser

Deck of Cards

id	bimUpdateCurrentUser

Card

label	URL / Resource / JSON Structure

Resource: user

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

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

Card

label	HTTP Method

PUT

Card

label	Description

Update information about the currently logged in user.

Card

label	Request / Response

Identical with Update User call

Anchor

	uploadUserPhoto
	uploadUserPhoto

Upload a photo of the user

Deck of Cards

id	bimUploadUserPhoto

Card

default	true
label	URL / Resource / JSON Structure

Resource: user/photo

URL: https://api-stage.bimplus.net/v2/user/photo

Example: https://api-stage.bimplus.net/v2/user/photo

Card

label	HTTP Method

POST

Card

label	Description

Upload a photo of the user. The token can also be passed as the query string if the client cannot use the token in the header request.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: multipart/form-data

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

{
    "photo": "/attachments/dfd38a17-4d55-4f1b-a2af-f2304b79e9e8/download",
    "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
    "email": "jayaraj.purushothaman@gmail.com"
}

Anchor

	downloadUserPhoto
	downloadUserPhoto

Download the photo of the user

Deck of Cards

id	bimDownloadUserPhoto

Card

default	true
label	URL / Resource / JSON Structure

Resource: user/photo

URL: https://api-stage.bimplus.net/v2/user/photo OR https://api-stage.bimplus.net/v2/user/photo?api-token=token (If the client cannot use the token in the header request)

Example: https://api-stage.bimplus.net/v2/user/photo OR https://api-stage.bimplus.net/v2/user/photo?api-token=9c1874a62c974dcfa75e0132c423a088

The photo could also be downloaded by using the the property of "photo"(which is a url) in the v2/user json response.

Card

label	HTTP Method

GET

Card

label	Description

Download the photo of the user. The token can be also provided as the query string for downloading the attachment( If the client cannot use the token in the header request)

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

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

Card

label	Response

Response content type is application/octet-stream

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Anchor

	forgotPassword
	forgotPassword

Forgot Password or Resend Invitation

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"
}

Anchor

	changePassword
	changePassword

Change Password

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 24

New Version 25

Key

User Management Service

User Management Service

Create a new user

Get information about the user

Update information about the user

Anchor
deleteUser
deleteUser

Delete the user

Get information about the currently logged in user

Upload a photo of the user

Download the photo of the user

Forgot Password or Resend Invitation

Change Password

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 24

New Version 25

Key

User Management Service

User Management Service

Create a new user

Get information about the user

Update information about the user

AnchordeleteUserdeleteUser

Delete the user

Get information about the currently logged in user

Upload a photo of the user

Download the photo of the user

Forgot Password or Resend Invitation

Change Password

Anchor
deleteUser
deleteUser