Versions Compared

Key

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

This web page is under construction. The JSON Request and Reply (Request and Reply tab) for the API calls are not complete.

Note

Please use

Newwindowlink
titlehttp://bimplus-dev.mantro.net
urlhttp://bimplus-dev.mantro.net
for the testing purposes because our productive server
Newwindowlink
titlehttps://api.bimplus.net
urlhttps://api.bimplus.net
is not available to the market yet.

Bim+ Services

...

Deck of Cards
idbimUpdateProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

PUT

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff

JSON Structure

Name

Mandatory / Optional

Type

Description

id

mandatory

guid

id of the project

name

optional

string

Name of the project

shortDescr

optional

string

Short description of the project

created

optional

date

Creation date of the project

changed

optional

date

Changed date of the project

Card
labelDescription

Update or replace a specified existing project with a new one.

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


Code Block
borderColorRed
langxml
titleJSON
{
"shortDescr" : "Updating the project"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK

...

Deck of Cards
idbimCreateIssue
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>issues

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/issues

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff/issues

JSON Structure

Name

Mandatory / Optional

Type

Description

projectId

mandatory

guid

Id of the project

name

optional

string

Name of the issue

description

optional

string

Description of the issue

author

optional

string

Author of the issue

status

optional

string

Status of the issue

createdAt

optional

date

Creation date of the issue

dueDate

optional

date

The date in which the issue is planned to be finished

solution

optional

 

 

classification

optional

string

 

priority

optional

string

 

Card
labelDescription

Creates a new issue in a project.

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
[3]
0:  {
id"projectId": "c8c8e6f20d2ce2cc-44953588-484c45d6-929da59a-0049f1f9d4fff6b89ebed34e",
"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"
}": "Fire Exit Wrong",
"description": "The fire exit is in the wrong place",
"author": "Mr. Smart",
"status": "open",
"createdAt": "2013-06-02T10:05:00",
"dueDate": "2013-06-05T10:05:00",
"classification": "",
"priority": "very high"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus

Status: 201 Created


Code Block
borderColorRed
langxml
titleJSON

{
    "projectId": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e",
    "name": "Fire Exit Wrong",
    "description": "The fire exit is in the wrong place",
    "author": "Mr. Smart",
    "status": "open",
    "createdAt": "2013-06-02T10:05:00+00:00",
    "dueDate": "2013-06-05T10:05:00+00:00",
    "solution": null,
    "classification": "",
    "priority": "very high",
    "revision": null,
    "id": "8ead8bfe-ab23-4340-ac47-38181e83bff3"
}


Get the Issue List from the project
Deck of Cards
idbimGetIssueList
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>issues 

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/issues

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff

Card
labelDescription

Get all the issues assigned to a specified project.

Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


[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" }
Code Block
borderColorRed
langxml
titleJSON
xml
titleJSON


Delete all the issues from the project
Deck of Cards
idbimDeleteIssueList
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

DELETE

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>issues 
URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/issues
Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff

Card
labelDescription

Delete all the issues belonging to a specified project.

Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
: 200 OK


[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" }
Code Block
borderColorRed
langxml
titleJSON
Code Block
borderColorRed
langxml
titleJSON


Create a new attachment in the project
Deck of Cards
idbimCreateAttachmentInProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/attachments 

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff/attachments

JSON Structure

Name

Mandatory / Optional

Type

Description

objectIds

optional

string

The id of the project objects to which the file has to be attached

fileName

optional

string

Name of the file to be attached to the project

type

optional

string

Mime type

size

optional

long

Size of the file to be attached to the project

Card
labelDescription

Creates a new attachment in a project.

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
[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"
}

...

Deck of Cards
idbimGetAttachmentListFromProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/attachments 

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff/attachments

Card
labelDescription

Get all the attachments belonging to a specified project.

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
[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"
}

...

Deck of Cards
idbimDeleteAttachmentListFromProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

DELETE

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/attachments 

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff

Card
labelDescription

Delete all the attachments belonging to a specified project.

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
[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"
}

...

Deck of Cards
idbimGetProjectDisc
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/disciplines 

URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>/disciplines

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff/disciplines

Card
labelDescription

Get the disciplines of a project.

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
[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"
}

...

Deck of Cards
idbimDeleteProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

DELETE

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id> 
URLhttps://api.bimplus.net/v2/<company>/projects/<project_id>

Examplehttps://api.bimplus.net/v2/bimplus/projects/c8c8e6f2-4495-484c-929d-0049f1f9d4ff

Card
labelDescription

Deletes a specified project.

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
[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"
}

...

Deck of Cards
idbimCreateComment
Card
labelImplementation Status

Service not finished yet !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: issues/<issue_id>/comments 

URLhttps://api.bimplus.net/v2/<company>/issues/<issue_id>/commentsExamplehttps://api.bimplus.net/v2/bimplus/projects

Examplehttps://api.bimplus.net/v2/bimplus/projects

JSON Structure:

Name

Mandatory / Optional

Type

Description

issueId

 

guid

The id of the issue to which the comment is related

text

 

string

The comment text

createdAt

 

date

Creation date of the comment

author

 

string

The author of the comment

Card
labelDescription

Create a new comment for a specified issue.

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
[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"
}

...

Deck of Cards
idbimAuthenticateToken
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: authorize 

URLhttps://api.bimplus.net/v2/<company>/authorize

Examplehttps://api.bimplus.net/v2/bimplus/projects

Card
labelDescription

Authenticate by requesting and receiving a token.

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


Code Block
borderColorRed
langxml
titleJSON

{
 "user_id" : "test@bimplus.net",
 "password" : "test"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSONJSON

{
"access_token": "9c1874a62c974dcfa75e0132c423a088"
"expires_in": 2591999
"token_type": "BimPlus"
}
[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"
}


Get token information
Deck of Cards
idbimGetTokenInfo
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: tokeninfo?access_token=<token>

URLhttps://api.bimplus.net/v2/<company>/tokeninfo?access_token=<token>

Examplehttps://api.bimplus.net/v2/bimplus/projects

Card
labelDescription

Get information about a specified token.

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
[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"
}

...

Deck of Cards
idbimCreateUser
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: users 

URLhttps://api.bimplus.net/v2/<company>/users

Examplehttps://api.bimplus.net/v2/bimplus/projects

JSON Structure:

Name

Mandatory / Optional

Type

Description

email

 

string

Email of the user

status

 

string

 

password

 

string

Password of the user

Card
labelDescription

Creates a new user account.

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
[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"
}

...

Deck of Cards
idbimUpdateUserInfo
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

PUT

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: users/<user_id> 

URLhttps://api.bimplus.net/v2/<company>/users/<user_id>

Examplehttps://api.bimplus.net/v2/bimplus/projects

JSON Structure:

Name

Mandatory / Optional

Type

Description

email

 

string

Email of the user

status

 

string

 

password

 

string

Password of the user

Card
labelDescription

Update information about a specified user.

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
[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"
}

...

Deck of Cards
idbimDeleteUserFromTeam
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

DELETE

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: <team_id>/members/<user_id> 

URLhttps://api.bimplus.net/v2/<company>/<team_id>/members/<user_id>

Examplehttps://api.bimplus.net/v2/bimplus/projects

Card
labelDescription

Deletes a specified user from a team.

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
[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"
}
Code Block
borderColorGreen
langxml
titleTest
test for null