Versions Compared

Key

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

...

Deck of Cards
idbimCreateProject
card
Card
labelURL / Resource / JSON Structure
Resource: projects 

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

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

JSON Structure

(date)

Name

Mandatory / Optional

Type

Description

idwill be ignoredstring (guid)Id of the project

name

mandatory

string

Name of the project

shortDescr

optional

string

Short description of the projectcreated

teamNamewill be ignoredstringCreation date of Name of the team to which the project belongs
teamSlug
labelHTTP Method
 POST
Card
defaulttrue
labelDescription
 Creates a new project.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
"name" : "Your Awesome Building",
"shortDescr" : "Example for creating a project"
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 201 Created
Code Block
borderColorRed
titleJSON
langxml
{
"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"
}

...

will be ignoredstringSlug of the team to which the project belongs
hasWriteAccesswill be ignoredbooleanDon't use this property. This property is not deleted to support the older clients

created

will be ignored

string (date)

Creation date of the project

createdBywill be ignoredJSON objectDetails of the Bimplus user who has created the project
changedwill be ignoredstring(date)Modified date of the project
changedBywill be ignoredJSON objectDetails of the Bimplus user who has created the project
addressoptionalstringAddress of the project
modelCountwill be ignoredintNumber of models in this project
memberCountwill be ignoredintNumber of members in this project
topicCountwill be ignoredintNumber of topics in this project
attachmentCountwill be ignoredintNumber of attachments in this project
sizewill be ignoredintSize of the project in bytes
sizeInMBwill be ignoredstringSize of the project in MB
disciplineswill be ignoredJSON objectDisciplines found under this project
rightswill be ignoredJSON objectThe rights the user has for this project
Card
labelHTTP Method
 POST
Card
defaulttrue
labelDescription
 Creates a new project.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
"name" : "Your Awesome Building",
"shortDescr" : "Example for creating a project"
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 201 Created
Code Block
borderColorRed
titleJSON
langxml
{
"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"
}

Anchor
getCurrentProjectList
getCurrentProjectList

Get the logged in user's project List
Deck of Cards
idbimGetCurrentProjectList
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects 

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the whole project list in which the logged in user has a project role
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
[
    {

...

Get the logged in user's project List
Deck of Cards
idbimGetCurrentProjectList
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects 

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the whole project list in which the logged in user has a project role
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
[
    {
        "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",
        "hasWriteAccess": false,
        "teamSlug": "company1",
        "rights": {
            "projectAdmin": false,
            "projectDelete": false,
            "projectEditid": false"586b02be-43b8-4e27-b698-e067e85e38e2",
        "name": "!!!!!_VORTEILSHAUS V40 SD45 "modelsCreateTraufeingang": false,
            "modelsViewAllshortDescr": false
"Hey, i am your favourite test entry",
  }
    },
    {"thumbnail": null,
        "idcreated": "0d2ce2cc2013-3588-45d6-a59a-f6b89ebed34e05-01T09:33:18",
        "namechanged": "Your Awesome Building2013-05-01T09:33:18",
        "shortDescrhasWriteAccess": "Example for creating a project"false,
        "thumbnailteamSlug": null"company1",
        "createdrights": "0001-01-01T00:00:00",
    {
    "changed": "0001-01-01T00:00:00",
        "hasWriteAccess": true,
        "teamSlug": "best-company",
        "rights": {
            "projectAdmin": truefalse,
            "projectDelete": truefalse,
            "projectEdit": truefalse,
            "modelsCreate": truefalse,
            "modelsViewAll": truefalse
        }
    },
    {
        "id": "4e87944a0d2ce2cc-a4773588-4e4c45d6-862ea59a-e723dcb43066f6b89ebed34e",
        "name": "UC_Fly-over KerensheideYour Awesome Building",
        "shortDescr": null,
"Example for creating a project",
        "thumbnail": null,
        "created": "20130001-0501-10T0701T00:1300:3800",
        "changed": "20130001-0501-16T0701T00:3400:5600",
        "hasWriteAccess": falsetrue,
        "teamSlug": "company2best-company",
        "rights": {
            "projectAdmin": falsetrue,
            "projectDelete": falsetrue,
            "projectEdit": falsetrue,
            "modelsCreate": falsetrue,
            "modelsViewAll": true
        }
    },
]

...

Get the user's project list from a team
Deck of Cards
idbimGetProjectList
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects 

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the project list with main properties from a particular team in which the user is a member of.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
[
    {    {
        "id": "4e87944a-a477-4e4c-862e-e723dcb43066",
        "name": "UC_Fly-over Kerensheide",
        "shortDescr": null,
        "thumbnail": null,
        "idcreated": "586b02be2013-43b8-4e27-b698-e067e85e38e205-10T07:13:38",
        "namechanged": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang2013-05-16T07:34:56",
        "shortDescrhasWriteAccess": "Hey, i am your favourite test entryfalse,
        "teamSlug": "company2",
        "thumbnailrights": null,{
        "created": "2013-05-01T09:33:18",
        "changed": "2013-05-01T09:33:18",
        "hasWriteAccess": false,
        "teamSlug": "company1",
        "rights": {
            "    "projectAdmin": false,
            "projectDelete": false,
            "projectEdit": false,
            "modelsCreate": false,
            "modelsViewAll": falsetrue
        }
    },
]

Anchor
getProjectList
getProjectList

Get the user's project list from a team
Deck of Cards
idbimGetProjectList
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects 

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the project list with main properties from a particular team in which the user is a member of.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
[
    {
        "id": "586b02be-43b8-4e27-b698-e067e85e38e2",
        "name": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang",
        "shortDescr": "Hey, i am your favourite test entry",
        "    {
        "id": "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e",
        "name": "Your Awesome Building",
        "shortDescr": "Example for creating a project",
        "thumbnail": null,
        "created": "00012013-0105-01T0001T09:0033:0018",
        "changed": "00012013-0105-01T0001T09:0033:0018",
        "hasWriteAccess": truefalse,
        "teamSlug": "best-companycompany1",
        "rights": {
            "projectAdmin": truefalse,
            "projectDelete": truefalse,
            "projectEdit": truefalse,
            "modelsCreate": truefalse,
            "modelsViewAll": truefalse
        }
    },
    {
        "id": "4e87944a0d2ce2cc-a4773588-4e4c45d6-862ea59a-e723dcb43066f6b89ebed34e",
        "name": "UC_Fly-over KerensheideYour Awesome Building",
        "shortDescr": null "Example for creating a project",
        "thumbnail": null,
        "created": "20130001-0501-10T0701T00:1300:3800",
        "changed": "20130001-0501-16T0701T00:3400:5600",
        "hasWriteAccess": falsetrue,
        "teamSlug": "company2best-company",
        "rights": {
            "projectAdmin": falsetrue,
            "projectDelete": falsetrue,
            "projectEdit": falsetrue,
            "modelsCreate": falsetrue,
            "modelsViewAll": true
        }
    },
]

...

Get the Project Properties
Deck of Cards
idbimGetProjectProp
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects/<project_id>

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Get all the project properties of a project using its id.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
{
    "name": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang",
    "shortDescr": "Hey, i am your favourite test entry",
    "thumbnail": null,
    "created": null,
    "changed": null,
    "disciplines": [
        {    {
        "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",
        "hasWriteAccess": false,
        "teamSlug": "company2",
        "rights": {
            "projectAdmin": false,
            "projectDelete": false,
            "projectEdit": false,
            "modelsCreate": false,
            "idmodelsViewAll": "0f106af0-a919-44c5-b211-15bd5ef620b6",
true
        }
    }
]

Anchor
getProjectProp
getProjectProp

Get the Project Properties
Deck of Cards
idbimGetProjectProp
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects/<project_id>

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

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

Card
labelHTTP Method
 GET
Card
labelDescription
 Get all the project properties of a project using its id.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
{
    "name": "!!!!!_VORTEILSHAUS V40 SD45 Traufeingang",
    "shortDescr": "Hey, i am your favourite test entry",
    "thumbnail": null,
    "created": null,
    "changed": null,
    "disciplines": ["name": "ID_BuildingModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "63b069d20f106af0-81dfa919-441844c5-91deb211-8a954fa1292415bd5ef620b6",
            "name": "ID_DesignModel_TimberBuildingModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "30114b5263b069d2-bc0581df-47c14418-80b591de-c7d5485d58408a954fa12924",
            "name": "ID_DesignModel_FinishModelTimber",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
        {
            "id": "09e623d430114b52-1e12bc05-4a7747c1-b35880b5-ea1d0b28e4a7c7d5485d5840",
            "name": "ID_RoomModelFinishModel",
            "divisionId": "ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "divisionName": null,
            "revisions": []
        },
    ],
    "rights": {
            "projectAdminid": false,"09e623d4-1e12-4a77-b358-ea1d0b28e4a7",
            "projectDeletename": false"ID_RoomModel",
            "projectEditdivisionId": false"ac21b9a1-8853-4658-9fbf-0cf62340bd18",
            "modelsCreatedivisionName": falsenull,
            "modelsViewAllrevisions": true[]
        }
    ],
    "id": "586b02be-43b8-4e27-b698-e067e85e38e2"
}

...

rights": {
            "projectAdmin": false,
            "projectDelete": false,
            "projectEdit": false,
            "modelsCreate": false,
            "modelsViewAll": true
        },
    "id": "586b02be-43b8-4e27-b698-e067e85e38e2"
}

Anchor
updateProject
updateProject

Update the project
Deck of Cards
idbimUpdateProject
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects/<project_id>

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

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

JSON Structure

Name

Mandatory / Optional

Type

Description

idwill be ignoredstring (guid)Id of the project

name

mandatory

string

Name of the project

shortDescr

optional

string

Short description of the project

teamNamewill be ignoredstringName of the team to which the project belongs
teamSlugwill be ignoredstringSlug of the team to which the project belongs
hasWriteAccesswill be ignoredbooleanDon't use this property. This property is not deleted to support the older clients

created

will be ignored

string (date)

Creation date of the project

createdBywill be ignoredJSON objectDetails of the Bimplus user who has created the project
changedwill be ignoredstring(date)Modified date of the project
changedBywill be ignoredJSON objectDetails of the Bimplus user who has created the project
addressoptionalstringAddress of the project
modelCountwill be ignoredintNumber of models in this project
memberCountwill be ignoredintNumber of members in this project
topicCountwill be ignoredintNumber of topics in this project
attachmentCountwill be ignoredintNumber of attachments in this project
sizewill be ignoredintSize of the project in bytes
sizeInMBwill be ignoredstringSize of the project in MB
disciplineswill be ignoredJSON objectDisciplines found under this project
rightswill be ignoredJSON objectThe rights the user has for this

...

Update the project
Deck of Cards
idbimUpdateProject
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: projects/<project_id>

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

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

JSON Structure

Changed date of the

Name

Mandatory / Optional

Type

Description

name

optional

string

Name of the project

shortDescr

optional

string

Short description of the project

created

will be ignored

string (date)

Creation date of the project

changed

will be ignored

string (date)

project
Card
labelHTTP Method
 PUT
Card
labelDescription
 Update or replace a specified existing project with a new one.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
    "properties": {
        "MainFloorArea": "456m²",
        "Architect": {
            "name": "NemetschekTech.GmbH",
            "phone1": "089/12793-1115",
            "phone2": "0171/71384483",
            "email": "MyName@Nemetschek.com",
            "city": "Munich",
            "zip": "81829",
            "street": "Konrad-Zuse-Platz1"
        },
        "Customer": {
            "name": "Bimplus customer",
            "phone1": "001-201-1279345",
            "email": "MyName@Nemetschek.com",
            "city": "New Jersy",
            "zip": "08201"
        }
    }
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK

...