User Management Service
- Create a new user
- Get information about the user
- Update information about the user
- Delete the user
- Get information about the currently logged in user
User Management Service
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
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 |
|---|---|---|---|
mandatory |
string |
Email of the user |
|
status |
optional |
will be ignored |
The status of the account (Active / Inactive) |
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 |
| 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) |
| projects | will be ignored | array | Project list of the user |
| project | will be ignored | object | Information about an user's project (See the project service) |
POST
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)
Headers
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
JSON
{
"email" : "test@bimplus.net",
"password" : "test"
}
Status
Status: 201 Created
JSON
{
"projects": [],
"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": ""
}
Get information about the user
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
GET
Get information about a specified user.
Headers
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status
Status: 200 OK
JSON
{
"projects": [],
"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": ""
}
Update information about the user
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 |
|---|---|---|---|
mandatory |
string |
Email of the user |
|
status |
mandatory |
string |
The status of the account (Active / Inactive) |
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 |
| 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) |
| projects | will be ignored | array | Project list of the user |
| project | will be ignored | object | Information about an user's project (See the project service) |
PUT
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)
Headers
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
JSON
{
"email": "updated_test@bimplus.net",
"status": "Active",
"password": "test"
}
Status
Status: 200 OK
Delete the user
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
DELETE
Delete a specified user. Please remember that this service can be used only by the shop/portal (secured using the application_id of portal)
Headers
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status
Status: 200 OK
Get information about the currently logged in user
Resource: user
URL: https://api-stage.bimplus.net/v2/user
GET
Get information about the currently logged in user.
Headers
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status
Status: 200 OK
JSON
{
"projects": [],
"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": ""
}
