Versions Compared

Key

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

...

Deck of Cards
idbimGetIssueDetails
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id> 

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

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3

Card
labelHTTP Method
 GET
Card
labelDescription
 Get details of an issue present in a project.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
langxml
{
    "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"
}

...

Deck of Cards
idbimGetIssueTypest
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/types 

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

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/types

Card
labelHTTP Method
 GET
Card
labelDescription
 Get all the available issue types.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaderslangxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
langxml
Status: 200 OK

Anchor
getIssueTypeDetails
getIssueTypeDetails

...

Deck of Cards
idbimGetIssueTypeDetails
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/types/<type_id> 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/types/<type_id>

Card
labelHTTP Method
 GET
Card
labelDescription
 Get details of a specified issue type.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaderslangxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
langxml
Status: 200 OK

Anchor
createPin
createPin

...

Deck of Cards
idbimCreatePin
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/pins 

URLhttps://api-stage.bimplus.net/v2//issues//pins

Examplehttps://api-stage.bimplus.net/v2//issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/pins

JSON Structure

Name

Mandatory / Optional

Type

Description

issueId

will be ignored

string (guid)

The id of the issue to which the pin is related

objectId

mandatory

string (guid)

The id of the object to which the pin is related

topologyNodeId

will be ignored

string (guid)

The id of the topology to which the pin is attached

position

optional

object

The position of the issue in the building (x,y,z co-ordinates)

normalVector

optional

object

The direction of the issue in the 3D space (x,y,z co-ordinates)

createdAt

will be ignored

date

Creation date of the pin

Card
labelHTTP Method
 POST
Card
labelDescription
 Create a new pin for an issue for relating the issue with its object.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
lang
borderColorRed
langxml
titleJSONxml
{
    "objectId": "7cf910cb-e357-43f6-aa3a-b45c26380f75",
    "position": {
        "x": "123.45",
        "y": "234.56",
        "z": "345.67"
    },
    "normalVector": {
        "x": "0",
        "y": "1",
        "z": "2"
    }
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
langxml
Status: 201 Created
Code Block
lang
borderColorRed
langxml
titleJSONxml
{
    "issueId": "8ead8bfe-ab23-4340-ac47-38181e83bff3",
    "objectId": "7cf910cb-e357-43f6-aa3a-b45c26380f75",
    "topologyNodeId": "387fa6cc-b6f9-4470-8c42-c07982aba660",
    "position": {
        "x": "123.45",
        "y": "234.56",
        "z": "345.67"
    },
    "normalVector": {
        "x": "0",
        "y": "1",
        "z": "2"
    },
    "createdAt": "2013-06-07T10:07:00+00:00",
    "id": "8836308d-f09f-4bb7-b6d2-354a2db205a6"
}

...

Deck of Cards
idbimGetAllPins
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/pins 

URLhttps://api-stage.bimplus.net/v2//issues//pins

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/pins

Card
labelHTTP Method
 GET
Card
labelDescription
 Get all the pins of a specified issue type.
Card
labelRequest
Code Block
lang
borderColorGreen
langxml
titleHeadersxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK
Code Block
lang
borderColorRed
langxml
titleJSONxml
[
    {
        "issueId": "8ead8bfe-ab23-4340-ac47-38181e83bff3",
        "objectId": "00000000-0000-0000-0000-000000000000",
        "topologyNodeId": "387fa6cc-b6f9-4470-8c42-c07982aba660",
        "position": {
            "x": 123.45,
            "y": 234.56,
            "z": 345.67
        },
        "normalVector": {
            "x": 0,
            "y": 1,
            "z": 2
        },
        "createdAt": "2013-06-07T10:07:00",
        "id": "8836308d-f09f-4bb7-b6d2-354a2db205a6"
    }
]

...

Deck of Cards
idbimDeleteAllPins
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/pins 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/<issue_id>/pins

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/pins

Card
labelHTTP Method
 DELETE
Card
labelDescription
 Delete all the pins from a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaderslangxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
langxml
Status: 200 OK

Anchor
createComment
createComment

...

Deck of Cards
idbimCreateCommentForIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/comments 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/<issue_id>/comments

Examplehttps://api-stage.bimplus.net/v2//issues/cb96a9b1-48c9-4d97-8c9e-262476c1c6b2/comments

JSON Structure:

Name

Mandatory / Optional

Type

Description

issueIdwill be ignoredstring(guid)The id of the issue

text

mandatory

string

The comment text

createdAt

will be ignored

string (date)

Creation date of the comment

modifiedAtwill be ignoredstring (date)Modified date of the comment

author

will be ignored

object

The author of the comment

Card
labelHTTP Method
 POST
Card
labelDescription
Create a new comment for a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaderslangxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
langxml
{
    "text": "The fire exit should be x:120, y: 120; z: 340"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 201 Created
Code Block
borderColorRed
langxml
titleJSONlangxml
{
    "issueId": "cb96a9b1-48c9-4d97-8c9e-262476c1c6b2",
    "text": "The fire exit should be x:120, y: 120; z: 340",
    "createdAt": "2013-07-02T13:26:18.8932853+00:00",
    "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "email": "",
        "firstname": "Unknown",
        "lastname": "User",
        "company": "",
        "fullname": "Unknown User",
        "displayname": "Unknown User",
        "info": "",
        "gender": "",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "",
            "streetNr": "",
            "zip": "",
            "city": "",
            "country": ""
        },
        "preferedLanguage": null
    },
    "id": "d258c905-c8af-4463-b0d8-ac09dbcfc255"
}

...

Deck of Cards
idbimGetAllCommentsFromIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/comments 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/<issue_id>/comments

Examplehttps://api-stage.bimplus.net/v2//issues/cb96a9b1-48c9-4d97-8c9e-262476c1c6b2/comments

Card
labelHTTP Method
 GET
Card
labelDescription
 Get all the comments of a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
lang
borderColorGreen
langxml
titleStatusxml
Status: 200 OK
Code Block
lang
borderColorRed
langxml
titleJSONxml
[
    {
        "issueId": "cb96a9b1-48c9-4d97-8c9e-262476c1c6b2",
        "text": "The fire exit should be x:120, y: 120; z: 340",
        "createdAt": "2013-07-02T13:26:18+00:00",
        "modifiedAt": "2013-07-03T13:26:18+00:00",
        "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "email": "",
        "firstname": "Unknown",
        "lastname": "User",
        "company": "",
        "fullname": "Unknown User",
        "displayname": "Unknown User",
        "info": "",
        "gender": "",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "",
            "streetNr": "",
            "zip": "",
            "city": "",
            "country": ""
        },
        "preferedLanguage": null
    },
        "id": "d258c905-c8af-4463-b0d8-ac09dbcfc255"
    }
]

...

Deck of Cards
idbimDeleteCommentFromIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/comments

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/<issue_id>/comments

Examplehttps://api-stage.bimplus.net/v2//issues/cb96a9b1-48c9-4d97-8c9e-262476c1c6b2/comments

Card
labelHTTP Method
 DELETE
Card
labelDescription
 Delete all the comments from the issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK

Anchor
createAttachmentForIssue
createAttachmentForIssue

...

Deck of Cards
idbimCreateAttachmentForIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/attachments 

URLhttps://api-stage.bimplus.net/v2//issues//attachments

Example:https://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/attachments

JSON Structure: Please note that all the information required for this call will be taken from the document that you attach and hence the request of this call has no body.

Name

Mandatory / Optional

Type

Description

objectIds

will be ignored

string

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

fileName

will be ignored

string

Name of the file to be attached to the project

type

will be ignored

string

Mime type

size

will be ignored

integer

Size of the file to be attached to the project

createdAtwill be ignoredstringCreation date of the attachment
creatorwill be ignoredobjectThe user who created the attachment
Card
labelHTTP Method
 POST
Card
labelDescription
 Creates a new attachment for a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: multipart/form-data
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 201 Created
Code Block
borderColorRed
langxml
titleJSONlangxml
    {
        "objectIds": [
            "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e"
        ],
        "fileName": "Building_Plan.jpg",
        "type": "image/jpeg",
        "size": 211258,
        "createdAt": "2013-12-11T10:47:39",
        "creator": {
        "id": "e18941f4-a809-2d01-d27d-cd251f2b6cb6",
        "email": "test@bimplus.net",
        "firstname": "First Name",
        "lastname": "Second Name",
        "company": "Best-Company",
        "fullname": "First Name Second Name",
        "displayname": "Best-Company",
        "info": "",
        "gender": "",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "Westermeier str.",
            "streetNr": "10",
            "zip": "81829",
            "city": "München",
            "country": "Germany"
        },
        "preferedLanguage": "en"
       },
        "id": "6cea110a-88f4-43ac-9a00-ebaf677be333"
    }

...

Deck of Cards
idbimGetAttachmentListFromIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/attachments 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/<issue_id>/attachments

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/attachments

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the attachment list from a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
lang
borderColorGreen
langxml
titleStatusxml
Status: 200 OK
Code Block
lang
borderColorRed
langxml
titleJSONxml
    {
        "objectIds": [
            "0d2ce2cc-3588-45d6-a59a-f6b89ebed34e"
        ],
        "fileName": "Building_Plan.jpg",
        "type": "image/jpeg",
        "size": 211258,
        "createdAt": "2013-12-11T10:47:39",
        "creator": {
        "id": "e18941f4-a809-2d01-d27d-cd251f2b6cb6",
        "email": "test@bimplus.net",
        "firstname": "First Name",
        "lastname": "Second Name",
        "company": "Best-Company",
        "fullname": "First Name Second Name",
        "displayname": "Best-Company",
        "info": "",
        "gender": "",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "Westermeier str.",
            "streetNr": "10",
            "zip": "81829",
            "city": "München",
            "country": "Germany"
        },
        "preferedLanguage": "en"
       },
        "id": "6cea110a-88f4-43ac-9a00-ebaf677be333"
    }

...

Deck of Cards
idbimDeleteAttachmentFromIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id>/attachments 

URLhttps://api-stage.bimplus.net/v2//issues//attachments

Example:https://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3/attachments

Card
labelHTTP Method
 DELETE
Card
labelDescription
Delete all the attachments from a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK

Anchor
issueHyperlink
issueHyperlink

...

Deck of Cards
idbimUpdateIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id> 

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

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3

JSON Structure

Name

Mandatory / Optional

Type

Description

shortIdwill be ignorednumberReadable unique issue number(always starts with 1 for each project)

projectId

will be ignored

string (guid)

Id of the project

name

optional

string

Name of the issue

description

optional

string

Description of the issue

author

optional

object

Author of the issue

responsibleoptionalobjectResponsible person for the issue

status

optional

string

Status of the issue. Should have one of the values: Open, Solved or Closed

createdAt

will be ignored

string (date)

Creation date of the issue

dueDate

optional

string (date)

The date in which the issue is planned to be finished

solution

optional

string

The proposed solution for the issue

classification

optional

string

The classification to which the issues belongs

priority

optional

string

The priority of the issue. Should have one of the values: Low, Medium or High

Card
labelHTTP Method
 PUT
Card
labelDescription
 Update or replace a specified existing issue with a new one.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSONlangxml
{
    "name": "Fire Exit Wrong",
    "description": "The fire exit is in the wrong place(x:120, y: 120; z: 340)",
    "author": "Mr. Smart",
    "status": "open"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK

Anchor
deleteIssue
deleteIssue

...

Deck of Cards
idbimDeleteIssue
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/<issue_id> 

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

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/8ead8bfe-ab23-4340-ac47-38181e83bff3

Card
labelHTTP Method
 DELETE
Card
labelDescription
 Deletes a specified issue.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK