Versions Compared

Key

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


Note

Help us improve the bim+ Bimplus API doc by providing your valuable comments. You can find the comment section at the bottom of the page.

Standard Procedure

Info

Developers please use

Newwindowlink
titlehttps://api-stage.bimplus.net/v2
urlhttps://api-stage.bimplus.net/v2
(stage version of Bimplus API) and Note: Please use 
Newwindowlink
titlehttp://bimplusportal-devstage.mantrobimplus.net/
urlhttp://bimplusportal-devstage.mantrobimplus.net
 for the testing purposes because our productive server 
/
(stage version of Shop/Portal) for testing purposes. The production version of the portal is located under 
Newwindowlink
titlehttps://
api
portal.bimplus.net/
urlhttps://
api
portal.bimplus.net
 is not available to the market yet
/
  and the base url of the API is different for the production version.

Generally, the Bim+ Bimplus REST API calls consist of five steps for accessing the resources.

1. Developer Registration

Generally our portal 

Newwindowlink
titleAllplan Bimplus portal
urlhttphttps://www.bimplus.netallplan.com/uk_en/products/allplan-bimplus/
is the first place of contact of the user /developer for using the bim+ Bimplus platform.

Please do the developer registration

Newwindowlink
titlehere
urlhttps://connect-stage.allplan.com/bimplus-freemium.html

...

.

You can find step by step manual here.

When you have any problems with the registration contact ushere.

2.
Anchor
authenticateToken
authenticateToken
 Authentication token request

The authentication request for accessing the BimPlus resource should be sent in the JSON format using the OIDC Authorization service. The registered user name and password in the

Newwindowlink
titleBimplus portal
urlhttphttps://wwwportal-stage.bimplus.net/
should be provided here.

For example, you can enable the OAuth 2.0 authentication process directly in your REST-client and it will automatically create and refresh tokens when needed.

It is recommended to use browser UI to login and logout with OIDC server. For this process, you can specify discovery URL and retrieve JSON with latest settings there.



Received token should be directly used to access BimPlus resources after receiving it from OIDC. Refreshing and revoking of the tokens are also managed by OIDC, not BimPlus. Old authentication service in BimPlus remains only for backward compatibility and will be removed in 2026.

Please, use the client_id from the request and regenerate the token (using the same API call with client_id as the additional parameter) for having the possibility to login multiple times at the same time. For more information, see here

Composition Setup



Deck of Cards
idrequestToken


Card
labelHTTP Method
POST POST


 
Card
labelURL / Resource / Parameters
 Resource: authorize 

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

JSON Structure

Name

Mandatory / Optional

Type

Description

user_id

mandatory

string

The email address of the user

password

mandatory

string

The user's password

client_id

mandatory

optional

string

The identifier of the used client (browser, Apps etc)

application_id

optional

mandatory

string

The id of the

application
where

application

_id will be one of the following:

Art-No

App

Platform

UID

Editions

 

 

 

AM00050000

bim+ Starter Edition

Cloud

df2dbfa44a2b89704d38e07175be8298

 

 

 

 

AM00050050

bim+ Business Edition

Cloud

2efa4c5a58b189e04f0af8879d6c3fca

 

 

 

 

AM00050100

bim+ Enterprise Edition

Cloud

685b24cf716e211e64f126d5347074e3

 

 

 

 

BTW

 

 

 

AM00050200

bim+ TeamWorks

Win

f6c5e0004f0ae73c485324a900a28a14

 

 

 

bim+ Apps

 

 

 

AM0005311

bim+ Explorer

iPad

c08181961a0cf078d740f402a18610a1

AM0005321

bim+ MyHouse Photo

iPad

13f8972af21a76036717f0e51db64184

AM0005331

bim+ Problem Spotter

iPad

13fe742a744959f7f849c30b63bcc4c0

AM0005341

bim+ Viewer

iPad

c087f3e4f242e974e6ca99f74cc4f6a0

 

 

 

 

3rd Party Apps

 

 

 

 

 

 

 

bim+ Services

 

 

 

AM00055000

bim+ WebViewer

Browser

 

 

 

 

 


Card
labelDescription
Obsolete. Authenticates a user and returns a token which can be used for further API calls for accessing the desired resources.


Card
defaulttrue
labelRequest


Code Block
borderColorGreen
titleHeaders

Content-Type: application/json


Code Block
borderColorRed
titleJSON
{
 "user_id" : "test@bimplus.net",
 "password" : "test",
 "clientapplication_id" : "1FD44C0E-DCB4-11E2-A114-67286288709B6C12345D9B0C4F3C23ABB5721D098F7B"
}



Card
labelResponse


Code Block
borderColorGreen
titleStatus

Status: 200 OK


Code Block
borderColorRed
titleJSON
{
"access_token": "9c1874a62c974dcfa75e0132c423a088",
"expires_in": 2591999,
"client_id" : "1FD44C0E-DCB4-11E2-A114-67286288709B"
"token_type": "BimPlus"
}



3. Receive the authentication token 

Obsolete. The token is received in the request.

Deck of Cards
idrequestToken


Card
labelHTTP Method
POST POST


Card
labelURL / Resource / Parameters
 Resource: authorize 

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


Card
labelDescription
Authenticates  Authenticates a user and returns a token which can be used for further API calls for accessing the desired resources.


Card
labelRequest


Code Block
borderColorGreen
titleHeaders

Content-Type: application/json


Code Block
borderColorRed
titleJSON
{
 "user_id" : "test@bimplus.net",
 "password" : "test",
 "clientapplication_id" : "1FD44C0E-DCB4-11E2-A114-67286288709B6C12345D9B0C4F3C23ABB5721D098F7B"
}



Card
defaulttrue
labelResponse


Code Block
borderColorGreen
titleStatus

Status: 200 OK


Code Block
borderColorRed
titleJSON
{
"access_token": "c939ebf5b96646528e0022a35f7a2e679c1874a62c974dcfa75e0132c423a088",
"expires_in": 2591999,
"client_id" : "1FD44C0E-DCB4-11E2-A114-67286288709B"
"token_type": "BimPlus"
}

where,

access_token

The token to be used in any further API calls within the HTTP headers

expires_in

The remaining lifetime on the access token in seconds

client_id

The identifier of the used client (browser, Apps etc)

token_type

The type of token – currently we use

‚bimplus'

‚bimplus‘



4. Get the team information

The team has to be specified and setup through the 

Newwindowlink
titlebimplusBimplus portal
urlhttphttps://wwwportal-stage.bimplus.net/
portal as so-called
Newwindowlink
titleslugs
urlhttp://en.wikipedia.org/wiki/Clean_URL#Slug/
 to present a
Newwindowlink
titleclean URL
urlhttp://en.wikipedia.org/wiki/Clean_URL/
. Slugs are lowercase unique identifiers based on English characters and numbers. The team slug will be used to know which tenant database to work on.

Deck of Cards
idgetTeamInfo


Card
labelHTTP Method
GET GET


Card
defaulttrue
labelURL / Resource / Parameters
 Resource: teams 

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


Card
labelDescription
Get  Get all the available teams.


Card
labelRequest


Code Block
borderColorGreen
titleHeaders

Authorization: BimPlus c939ebf5b96646528e0022a35f7a2e679c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
titleStatus

Status: 200 OK


Code Block
borderColorRed
titleJSON
[2]
0:  {
id: "82884f54-96bf-4e9c-a2fb-44db8379378d"
slug: "nemetschek"
name: "Nemetschek"
owner: "132a78a5-b523-4bf2-8382-7098fac3f803"
totalStorage: 0
storageStats: null
status: "Active"
teamWorksConnection: "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0OyBJbml0aWFsIENhdGFsb2c9QmltUGx1cy5UZW5hbnQuRGV2OyBVc2VyIElkPWRiYmltbWFudHJvdGVzdDsgUGFzc3dvcmQ9MWprdGNudG9DcU9qeGtIMU9QOXg7IENvbm5lY3QgdGltZW91dD0xMA=="
dataStorageStatus: "Online"
}-
1:  {
id: "7eab1453-a4e7-4d05-983e-031544540e6f"
slug: "bimplus-demo"
name: "BimPlus Demo"
owner: "5592c628-588e-f5c0-b08b-088d43de9209"
totalStorage: 53687091200
storageStats: null
status: "Active"
teamWorksConnection: "RGF0YSBTb3VyY2U9YmltcGx1cy5tYW50cm8ubmV0O0luaXRpYWwgQ2F0YWxvZz1CaW1QbHVzLlRlbmFudC5iaW1wbHVzLWRlbW87VXNlciBJRD1iaW1wbHVzLWRlbW87UGFzc3dvcmQ9YWI3ZDRmNDc5ZGM4YjI1Yjg2MDc0Y2ZmZTNiNDBjZmY2OWQwNzQ1YjtDb25uZWN0IFRpbWVvdXQ9MTA="
dataStorageStatus: "Online"
}



5. Request the desired resource

Using the authentication token and the team slug, the necessary resource can be accessed and the desired action can be performed on that resource using the

Newwindowlink
titleBimplus REST API
urlhttps://nrldevdoc.nemetschekallplan.com/confluencedisplay/pages/viewpage.action?pageId=4459171bimpluspublic/Bimplus+API+Reference
.

For example, we can use this token to get the project list.

Deck of Cards
idexampleGetProjectList


Card
labelHTTP Method
GET GET


Card
labelURL / Resource / Parameters
 Resource: projects 

URLhttps://api-stage.bimplus.net/v2/<team>/projects

Examplehttps://api-stage.bimplus.net/v2/nemetschek/projects


Card
labelDescription
Get  Get available project list with main properties.


Card
defaulttrue
labelRequest


Code Block
borderColorGreen
titleHeaders

Authorization: BimPlus c939ebf5b96646528e0022a35f7a2e679c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
titleStatus

Status: 200 OK


Code Block
borderColorRed
titleJSON
[3]
0:  {
id: "c8c8e6f2-4495-484c-929d-0049f1f9d4ff"
name: "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang"
}-
1:  {
id: "2d703abe-b4f9-407c-af53-a39c5b7ba872"
name: "__5 999 Parklife Salzburg Lehen"
}-
2:  {
id: "c480cc54-aec4-4bef-8d35-93bb090e1aba"
name: "0811-Wohnhaus Kraus - Carport1"
}




Tools 

Anchor
Tools
Tools

Plugins for doing REST based calls (REST Client) 

...