Versions Compared

Key

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

...

Anchor
ProjectService
ProjectService

...

...

Create a new project
Anchor
createProject
createProject

...

Deck of Cards
idbimCreateProject
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects 

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

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

JSON Structure

Name

Mandatory / Optional

Type

Description

name

optional

string

Name of the project

shortDescr

optional

string

Short description of the project

created

optional

string (date)

Creation date of the project

Card
labelDescription

Creates a new project.

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


Code Block
borderColorRed
langxml
titleJSON
{
"name" : "Your Awesome Building",
"shortDescr" : "Example for creating a project"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created


Code Block
borderColorRed
langxml
titleJSON
{
"name": "Your Awesome Building",
"shortDescr": "Example for creating a project",
"thumbnail": null,
"created": "2013-06-01T10:05:00",
"changed": null,
"disciplines": null,
"id": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e"
}


...

Get the Project List
Anchor
getProjectList
getProjectList

...

Deck of Cards
idbimGetProjectList
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects 

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

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

Card
labelDescription

Gets the available project list with main properties.

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": "586b02be-43b8-4e27-b698-e067e85e38e2",
        "name": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang",
        "shortDescr": "Hey, i am your favourite test entry",
        "thumbnail": null,
        "created": "2013-05-01T09:33:18",
        "changed": "2013-05-01T09:33:18"
    },
    {
        "id": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e",
        "name": "Your Awesome Building",
        "shortDescr": "Example for creating a project",
        "thumbnail": null,
        "created": "0001-01-01T00:00:00",
        "changed": "0001-01-01T00:00:00"
    },
    {
        "id": "4e87944a-a477-4e4c-862e-e723dcb43066",
        "name": "UC_Fly-over Kerensheide",
        "shortDescr": null,
        "thumbnail": null,
        "created": "2013-05-10T07:13:38",
        "changed": "2013-05-16T07:34:56"
    }
]


...

Get the Project Properties
Anchor
getProjectProp
getProjectProp

...

Deck of Cards
idbimGetProjectProp
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>

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

Examplehttps://api.bimplus.net/v2/bimplus/projects/586b02be-43b8-4e27-b698-e067e85e38e2

Card
labelDescription

Get all the project properties of a project using its id.

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
{
    "name": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang",
    "shortDescr": "Hey, i am your favourite test entry",
    "thumbnail": null,
    "created": null,
    "changed": null,
    "disciplines": [
        {
            "id": "0f106af0-a919-44c5-b211-15bd5ef620b6",
            "name": "ID_BuildingModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "63b069d2-81df-4418-91de-8a954fa12924",
            "name": "ID_DesignModel_Timber",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "30114b52-bc05-47c1-80b5-c7d5485d5840",
            "name": "ID_FinishModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "09e623d4-1e12-4a77-b358-ea1d0b28e4a7",
            "name": "ID_RoomModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        }
    ],
    "id": "586b02be-43b8-4e27-b698-e067e85e38e2"
}


...

Update the project
Anchor
updateProject
updateProject

...

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/<team>/projects/<project_id>

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e

JSON Structure

Name

Mandatory / Optional

Type

Description

name

optional

string

Name of the project

shortDescr

optional

string

Short description of the project

created

optional

string (date)

Creation date of the project

changed

optional

string (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


...

Create an issue in the project
Anchor
createIssue
createIssue

...

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/<team>/projects/<project_id>/issues

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/issues

JSON Structure

Name

Mandatory / Optional

Type

Description

projectId

mandatory

string (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

string (date)

Creation date of the issue

dueDate

optional

string (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


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",
"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
Anchor
getIssueList
getIssueList

...

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/<team>/projects/<project_id>/issues

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/issues

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


Code Block
borderColorRed
langxml
titleJSON


...

Delete all the issues from the project
Anchor
deleteIssues
deleteIssues

...

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/<team>/projects/<project_id>/issues

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/issues

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


...

Create a new attachment in the project
Anchor
createAttachment
createAttachment

...

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/<team>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/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

integer

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


Code Block
borderColorRed
langxml
titleJSON
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created


Code Block
borderColorRed
langxml
titleJSON


...

Get the Attachment List from the project
Anchor
getAttachments
getAttachments

...

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/<team>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/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


...

Delete all the attachments from the project
Anchor
deleteAttachments
deleteAttachments

...

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/<team>/projects/<project_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/attachments

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


...

Get the project topology tree
Anchor
getProjectTopology
getProjectTopology

...

Deck of Cards
idbimGetObject5bimGetProjectTopology
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/topology

URL: https://api.bimplus.net/v2/<team>/projects/<project_id>/topology

Example: https://api.bimplus.net/v2/bimplus/projects/0d2ce2cc-3588-45d6-a59a-f6b89ebed34e/topology

Card
labelDescription

Get the project topology tree.

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
{
    "parent": null,
    "name": null,
    "type": "Project",
    "children": [
        {
            "parent": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e",
            "name": null,
            "type": "ID_TopologyDivision",
            "children": [],
            "id": "195db084-3715-4ebc-b164-3ee47a495b2e"
        }
    ],
    "id": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e"
}


...

Get the project disciplines
Anchor
getProjectDisciplines
getProjectDisciplines

...

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/<team>/projects/<project_id>/disciplines

Examplehttps://api.bimplus.net/v2/bimplus/projects/586b02be-43b8-4e27-b698-e067e85e38e2/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
[
    {
        "id": "0f106af0-a919-44c5-b211-15bd5ef620b6",
        "name": "ID_BuildingModel",
        "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
        "divisionName": null,
        "revisions": []
    },
    {
        "id": "63b069d2-81df-4418-91de-8a954fa12924",
        "name": "ID_DesignModel_Timber",
        "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
        "divisionName": null,
        "revisions": []
    },
    {
        "id": "30114b52-bc05-47c1-80b5-c7d5485d5840",
        "name": "ID_FinishModel",
        "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
        "divisionName": null,
        "revisions": []
    },
    {
        "id": "09e623d4-1e12-4a77-b358-ea1d0b28e4a7",
        "name": "ID_RoomModel",
        "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
        "divisionName": null,
        "revisions": []
    }
]


...

Create / Upload a thumbnail to the project
Anchor
createThumbnail
createThumbnail

...

Deck of Cards
idbimCreateThumbnail
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

POST

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/thumbnail

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

Examplehttps://api.bimplus.net/v2/bimplus/projects/586b02be-43b8-4e27-b698-e067e85e38e2/thumbnail

Card
labelDescription

Creates or uploads a thumbnail to the project.

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


Code Block
borderColorRed
langxml
titleJSON
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created


Code Block
borderColorRed
langxml
titleJSON


...

Download the thumbnail
Anchor
downloadThumbnail
downloadThumbnail

...

Deck of Cards
idbimGetProjectDisc
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: projects/<project_id>/thumbnail/download

URLhttps://api.bimplus.net/v2/<team>/projects/<project_id>/thumbnail/download

Examplehttps://api.bimplus.net/v2/bimplus/projects/586b02be-43b8-4e27-b698-e067e85e38e2/thumbnail/download

Card
labelDescription

Downloads the thumbnail.

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

...

Deck of Cards
idbimGetObjAttachment
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

GET

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: objects/<object_id>attachments 

URLhttps://api.bimplus.net/v2/<team>/objects/<object_id>attachments

Examplehttps://api.bimplus.net/v2/bimplus/objects/7cf910cb-e357-43f6-aa3a-b45c26380f75/attachments

Card
labelDescription

Get all the attachments belonging to a specified object.

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


...

Delete all the attachments from the project

...

Deck of Cards
idbimDeleteObjAttachment
Card
labelImplementation Status

 Service available !

Card
labelHTTP Method

DELETE

Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: objects/<object_id>/attachments 

URLhttps://api.bimplus.net/v2/<team>/objects/<object_id>/attachments

Examplehttps://api.bimplus.net/v2/bimplus/objects/7cf910cb-e357-43f6-aa3a-b45c26380f75/attachments

Card
labelDescription

Delete all the attachments from 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

...