Standard Procedure
Generally, the Bim+ REST API calls consist of three steps for accessing the resources.
...
Note |
---|
Note: Please use Newwindowlink |
---|
title | http://bimplus-dev.mantro.net |
---|
url | http://bimplus-dev.mantro.net |
---|
| for the testing purposes because our productive server Newwindowlink |
---|
title | https://api.bimplus.net |
---|
url | https://api.bimplus.net |
---|
| is not available to the market yet. |
1. Authentication token request
The authentication request for accessing the BimPlus resource should be sent in the JSON format using the Authorization service.
...
Deck of Cards |
---|
|
Card |
---|
label | Implementation Status |
---|
| Service available ! |
Card |
---|
label | URL / Resource / Parameters |
---|
| Resource: authorize URL: https://api.bimplus.net/v2/authorize |
Card |
---|
| Authenticates a user and returns a token which can be used for further API calls for accessing the desired resources. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Headers |
---|
|
Content-Type: application/json
|
Code Block |
---|
| {
"user_id" : "test@bimplus.net",
"password" : "test"
} |
|
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Status |
---|
|
Status: 200 OK
|
Code Block |
---|
| {
access_token: "9c1874a62c974dcfa75e0132c423a088"
expires_in: 2591999
token_type: "BimPlus"
} |
|
|
2. Receive the authentication token
The token is received in the request.
Deck of Cards |
---|
|
Card |
---|
label | Implementation Status |
---|
| Service available ! |
Card |
---|
label | URL / Resource / Parameters |
---|
| Resource: authorize URL: https://api.bimplus.net/v2/authorize |
Card |
---|
| Authenticates a user and returns a token which can be used for further API calls for accessing the desired resources. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Headers |
---|
|
Content-Type: application/json
|
Code Block |
---|
| {
"user_id" : "test@bimplus.net",
"password" : "test"
} |
|
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Status |
---|
|
Status: 200 OK
|
Code Block |
---|
| {
access_token: "c939ebf5b96646528e0022a35f7a2e67"
expires_in: 2591999
token_type: "BimPlus"
} |
|
|
The team has to be specified and setup through the
Newwindowlink |
---|
title | bimplus |
---|
url | http://www.bimplus.net/ |
---|
|
portal as so-called
Newwindowlink |
---|
title | slugs |
---|
url | http://en.wikipedia.org/wiki/Clean_URL#Slug/ |
---|
|
to present a
Newwindowlink |
---|
title | clean URL |
---|
url | http://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. If you are not sure of your team slug please use our
Newwindowlink |
---|
title | user administration service |
---|
url | https://nrldev.nemetschek.com/confluence/display/bimpluspublic/2.1.3+User+Administration+Service/ |
---|
|
.
Deck of Cards |
---|
|
Card |
---|
label | Implementation Status |
---|
| Service available ! |
Card |
---|
default | true |
---|
label | URL / Resource / Parameters |
---|
| Resource: teams URL: https://api.bimplus.net/v2/teams |
Card |
---|
| Get all the available teams. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Headers |
---|
|
Authorization: BimPlus c939ebf5b96646528e0022a35f7a2e67
Content-Type: application/json
|
|
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Status |
---|
|
Status: 200 OK
|
Code Block |
---|
| [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"
} |
|
|
4. 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 BimPlus REST API.
...
Deck of Cards |
---|
|
Card |
---|
label | Implementation Status |
---|
| Service available ! |
Card |
---|
label | URL / Resource / Parameters |
---|
| Resource: projects URL: https://api.bimplus.net/v2/<team>/projects Example: https://api.bimplus.net/v2/nemetschek/projects |
Card |
---|
| Get available project list with main properties. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Headers |
---|
|
Authorization: BimPlus c939ebf5b96646528e0022a35f7a2e67
Content-Type: application/json
|
|
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
title | Status |
---|
|
Status: 200 OK
|
Code Block |
---|
| [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"
} |
|
|
Plugins for doing REST based calls (REST Client)
...