This page is under construction
User Settings Service
- Create an user setting
- Get the list of pre-defined user settings
- Get info about a setting
- Update a setting
- Delete a setting
User Settings Service
User settings are used for configuring the settings that belongs to particular user. eg: Whether the user would like receive notifications or not, what type of notification, pin-size, model opacity etc., Please remember that the application_id has to be provided in the authentication request for using these services. Each combination of userId - applicationId is unique (which means the settings are relevant only to a particular application)
Get the list of pre-defined user settings
URL: https://api-stage.bimplus.net/v2/application/settings
Example:https://api-stage.bimplus.net/v2/application/settings
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status: 200 OK
[
{
"key": "AutoLoadLastModel",
"value": "Yes",
"updated": "2015-08-19T00:04:16.387",
"id": "c47b737c-6727-4832-bcd1-57ead714ae34"
},
{
"key": "AutoProjectReordering",
"value": "Yes",
"updated": "2015-08-19T00:04:16.403",
"id": "f148d6be-b62e-467e-8584-274c8befa5c7"
},
{
"key": "BrowserType",
"value": "32",
"updated": "2015-08-19T00:04:16.43",
"id": "8b843b7d-c99d-4cf1-882d-dac7f502d28d"
},
{
"key": "DateFormat",
"value": "dd.mm.yy",
"updated": "2015-08-19T00:04:16.443",
"id": "74c47450-164c-4c83-adf6-32d349cff857"
},
{
"key": "DefaultOpacity",
"value": "0.5",
"updated": "2015-08-19T00:04:16.44",
"id": "fddfbbff-5812-4b94-9027-a3c17559096a"
},
{
"key": "Notifications",
"value": "Yes",
"updated": "2015-08-19T00:04:16.36",
"id": "177ae6e5-f02b-44ed-a516-c22264d264b2"
},
{
"key": "NotificationType",
"value": "Email,Browser",
"updated": "2015-08-19T00:04:16.38",
"id": "5599c2c3-d502-4fe8-8626-c6d0616fe888"
},
{
"key": "PinFlyToDistance",
"value": "20000",
"updated": "2015-08-19T00:04:16.433",
"id": "159f69e6-d952-4b86-aac2-5fed7e59b25a"
},
{
"key": "PinSize",
"value": "2",
"updated": "2015-08-19T00:04:16.39",
"id": "a726ffe3-3341-47e6-8ae2-a255a306c658"
},
{
"key": "ProjectOrderRule",
"value": "lastOpened",
"updated": "2015-08-19T00:04:16.423",
"id": "de286dcb-86c2-4279-9bd3-3e586dcae8d8"
},
{
"key": "SlideDelay",
"value": "3",
"updated": "2015-08-19T00:04:16.397",
"id": "d97f3810-e50d-48b3-b57f-a6cd182c2788"
},
{
"key": "StatusHideDelay",
"value": "5",
"updated": "2015-08-19T00:04:16.4",
"id": "8a84d9ad-13fb-4529-8dd4-2700f06870b4"
}
]
Get info about a setting
URL: https://api-stage.bimplus.net/v2/application/settings
Example:https://api-stage.bimplus.net/v2/application/settings
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status: 200 OK
{
"issueId": "8ead8bfe-ab23-4340-ac47-38181e83bff3",
"objectId": "7cf910cb-e357-43f6-aa3a-b45c26380f75",
"topologyNodeId": "387fa6cc-b6f9-4470-8c42-c07982aba660",
"position": {
"x": 123.45,
"y": 234.56,
"z": 345.67
},
"normalVector": {
"x": 0,
"y": 1,
"z": 2
},
"createdAt": "2013-06-07T10:07:00",
"id": "8836308d-f09f-4bb7-b6d2-354a2db205a6"
}
Update a setting
URL: https://api-stage.bimplus.net/v2/<team_slug>/pins/<pin_id>
Example: https://api-stage.bimplus.net/v2/bimplus/pins/8836308d-f09f-4bb7-b6d2-354a2db205a6
JSON Structure:
Name |
Mandatory / Optional |
Type |
Description |
|---|---|---|---|
issueId |
mandatory |
string (guid) |
The id of the issue to which the pin is related |
objectId |
mandatory |
string (guid) |
The id of the object to which the pin is related |
newObjectId |
optional |
string (guid) |
It should be specified when the pin is assigned to another object via update |
topologyNodeId |
optional |
string (guid) |
The id of the topology to which the pin is attached |
position |
optional |
object |
The position of the issue in the building (x,y,z co-ordinates) |
normalVector |
optional |
object |
The direction of the issue in the 3D space (x,y,z co-ordinates) |
createdAt |
will be ignored |
date |
Creation date of the pin |
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
{
"issueId": "8ead8bfe-ab23-4340-ac47-38181e83bff3",
"objectId": "7cf910cb-e357-43f6-aa3a-b45c26380f75",
"position": {
"x": 123.45,
"y": 234.56,
"z": 345.67
},
"normalVector": {
"x": 0,
"y": 1,
"z": 2
}
}
Status: 200 OK
Delete a setting
URL: https://api-stage.bimplus.net/v2/<team_slug>/pins/<pin_id>
Example: https://api-stage.bimplus.net/v2/bimplus/pins/8836308d-f09f-4bb7-b6d2-354a2db205a6
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088 Content-Type: application/json
Status: 200 OK
