Versions Compared

Key

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

...

Deck of Cards
idbimCreateNewTeam


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: teams 

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

JSON Structure

Name

Mandatory / Optional

Type

Description

slug

optional

string

The unique name which will be used in the url. If not set, server will generate it from the team's name.

name

mandatory

string

Name of the team

displaynamewill be ignoredstringThe name of the team which will be displayed in the client

owner

mandatory

string (guid)

The unique identifier of the user who will be the initial owner

totalStorage

mandatory

integer (MB)

The total storage allocated to the the team (the initial storage size as ordered in the shop) obsolete since 2016

storageStats

will be ignored

integer

The storage statistics of the team (usedSpace, numberOfProjects, numberOfMembers, totalSpace, totalNumberOfProjects, totalNumberOfMembers)

status

will be ignored

string

Active / Disabled

teamWorksConnection

optional

string

Base64 encoded database connection string for legacy applications

dataStorageStatus

optional

string

Online / Offline

publicoptionalobject (json)Public read/write rights. Has two boolen properties : "read" and "write".
rightsoptionalobject (json)Project rights. It's a json with only one boolean property "projectCreate", which defines whether a user can create a project for this team.
accountTypeoptionalstringAccount type e.g. "Free", "Premium", ...
ismyteamwill be ignoredbooleanIs this team the user's team - true/false



Card
labelHTTP Method
 POST


Card
labelDescription
 Create a new team and its related database. Please remember that this service can be used only by the shop/portal (secured using the application_id of portal)


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json


Code Block
borderColorRed
langxml
titleJSON
{
    "slug": "best-company",
    "name": "Best Company",
    "owner": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6",
    "totalStorage": 500000000,
    "teamWorksConnection": "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0O0luaXRpYWwgQ2F0YWxvZz1CaW1QbHVzLlRlbmFudC5BTUFaT05BLU1OVU8wMTcudGhlLWJlc3Q7VXNlciBJRD10aGUtYmVzdDtQYXNzd29yZD00YmZhZWVlZTM5NDBmZjI0ZjhhNjg2MmIxMzk3NzUyYWU1MjlkZDIzO0Nvbm5lY3QgVGltZW91dD0xMA==",
    "dataStorageStatus": "Online",
    "haswriteaccess": false
}



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created


Code Block
borderColorRed
langxml
titleJSON
{
    "id": "db038754-2598-4616-9ea2-2c0947f2e93a",
    "slug": "best-company",
    "name": "Best Company",
    "displayname" : "Best Company"
    "owner": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6",
    "totalStorage": 500000000,
    "storageStats": {
        "usedSpace": 0,
        "numberOfProjects": 0,
        "numberOfMembers": 0,
        "totalSpace": 500000000,
        "totalNumberOfProjects": 0,
        "totalNumberOfMembers": 0
    },
    "status": "Active",
    "teamWorksConnection":     "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0O0luaXRpYWwgQ2F0YWxvZz1CaW1QbHVzLlRlbmFudC5BTUFaT05BLU1OVU8wMTcudGhlLWJlc3Q7VXNlciBJRD10aGUtYmVzdDtQYXNzd29yZD00YmZhZWVlZTM5NDBmZjI0ZjhhNjg2MmIxMzk3NzUyYWU1MjlkZDIzO0Nvbm5lY3QgVGltZW91dD0xMA==",
    "dataStorageStatus": "Online",
    "ismyteam": true,
    "public": {
        "read": false,
        "write": false
    },
    "rights": {
        "projectCreate": true
    }  
}



...

Deck of Cards
idbimGetTeamFromCurrentUser


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: teams 

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


Card
labelHTTP Method
 GET


Card
labelDescription
 Get a team list in which the current logged in user is a member of


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[
    {
        "id": "db038754-2598-4616-9ea2-2c0947f2e93a",
        "slug": "best-company",
        "name": "Best Company",
        "displayname": "Best Company (best-company)",
        "owner": "b8615afc-99cc-4bcd-b0ca-ff0593ce15c6",
        "status": "Active",
        "teamWorksConnection": "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0O0luaXRpYWwgQ2F0YWxvZz1CaW1QbHVzLlRlbmFudC5BTUFaT05BLU1OVU8wMTcudGhlLWJlc3Q7VXNlciBJRD10aGUtYmVzdDtQYXNzd29yZD00YmZhZWVlZTM5NDBmZjI0ZjhhNjg2MmIxMzk3NzUyYWU1MjlkZDIzO0Nvbm5lY3QgVGltZW91dD0xMA==",
        "dataStorageStatus": "Online",
        "ismyteam": true,
        "rights": {
            "projectCreate": true
        }
    },
    {
        "id": "82884f54-96bf-4e9c-a2fb-44db8379378d",
        "slug": "nemetschek",
        "name": "Nemetschek",
        "displayname": "Nemetschek (nemetschek)",
        "owner": "132a78a5-b523-4bf2-8382-7098fac3f803",
        "status": "Active",
        "teamWorksConnection": "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0OyBJbml0aWFsIENhdGFsb2c9QmltUGx1cy5UZW5hbnQuRGV2OyBVc2VyIElkPWRiYmltbWFudHJvdGVzdDsgUGFzc3dvcmQ9MWprdGNudG9DcU9qeGtIMU9QOXg7IENvbm5lY3QgdGltZW91dD0xMA==",
        "dataStorageStatus": "Online",
        "ismyteam": false,
        "rights": {
            "projectCreate": false
        }
    },
    {
        "id": "7eab1453-a4e7-4d05-983e-031544540e6f",
        "slug": "bimplus-demo",
        "name": "BimPlusDemo",
        "displayname": "BimPlusDemo (bimplus-demo)",
        "owner": "5592c628-588e-f5c0-b08b-088d43de9209",
        "status": "Active",
        "teamWorksConnection": "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0O0luaXRpYWwgQ2F0YWxvZz1CaW1QbHVzLlRlbmFudC5iaW1wbHVzLWRlbW87VXNlciBJRD1iaW1wbHVzLWRlbW87UGFzc3dvcmQ9YWI3ZDRmNDc5ZGM4YjI1Yjg2MDc0Y2ZmZTNiNDBjZmY2OWQwNzQ1YjtDb25uZWN0IFRpbWVvdXQ9MTA=",
        "dataStorageStatus": "Online",
        "ismyteam": false,
        "rights": {
            "projectCreate": false
        }
    }
]

 




Anchor
getAccountSettings
getAccountSettings

...

Deck of Cards
idbimGetTeamAccountSettings


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: teams/<team_id>/accountsettings

URLhttps://api-stage.bimplus.net/v2/administration/teams/<team_id>/accountsettings

Examplehttps://api-stage.bimplus.net/v2/administration/teams/f4b1178d-385f-449c-a2a7-6f58b264d90c/accountsettings


Card
labelHTTP Method
 GET


Card
labelDescription

 Get account settings of given team.

Predefined account settings are :

  • MaxProjects - maximum number of projects in the team
  • MaxTeamMembers - maximum number of team members
  • CreateRevisions - are revisions activated in the projects of this team
  • ClashDetection - is clash detection functionality allowed
  • ...
 


It is also possible to filter the list of account settings, using query parameter "settingName", e.g. :

https://api-stage.bimplus.net/v2/administration/teams/f4b1178d-385f-449c-a2a7-6f58b264d90c/accountsettings?settingName=ClashDetection&settingName=CreateRevisions


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[
  {
    "id": "826668e2-346b-4d5b-baf1-075e0b59dff5",
    "teamId": "31cb1181-2cbc-49dc-883a-0620e20140a4",
    "settingName": "ClashDetection",
    "value": "true",
    "expirationDate": "2016-11-04T00:00:00"
  },
  {
    "id": "78a9550e-54d6-4618-be00-203d8be68b05",
    "teamId": "31cb1181-2cbc-49dc-883a-0620e20140a4",
    "settingName": "MaxProjects",
    "value": "20",
    "expirationDate": null
  },
  {
    "id": "455b1bf9-fbdf-4a13-9fae-92ca659d06a0",
    "teamId": "31cb1181-2cbc-49dc-883a-0620e20140a4",
    "settingName": "MaxTeamMembers",
    "value": "10",
    "expirationDate": null
  },
  {
    "id": "42228d13-a4e7-4586-99cc-ae3791580842",
    "teamId": "31cb1181-2cbc-49dc-883a-0620e20140a4",
    "settingName": "CreateRevisions",
    "value": "true",
    "expirationDate": null
  }
]



...