Versions Compared

Key

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

...

Deck of Cards
idbimCreateSlide
Card
labelHTTP Method
 POST
Card
defaulttrue
labelURL / Resource / JSON Structure
 Resource: slideshows/<slideshow_id>/slides 

URLhttps://api-stage.bimplus.net/v2/<team_slug>/slideshows/<slideshow_id>/slides

Examplehttps://api-stage.bimplus.net/v2/bimplus/slideshows/30f4495a-79d7-48e4-8060-8a52350cfcd9/slides

JSON Structure

Name

Mandatory / Optional

Type

Description

name

optional

string

Name of the slide

descriptionoptionalstringDescription of the slide
slideInfooptionalstring 
sceneoptionalobject

A JSON string which includes viewMode(transparent or not), camera values & positions, related objects, clipping plane, topology & layer details. An example template is specified below.

Please remember, the server will process the scene information as a json string and hence the client has to take care on the information that is stored & retrieved.

authorwill be ignoredobject (user)Information about the user who has created the slide
createdwill be ignoredstring (date)Creation date of the slide
idwill be ignoredstring (id)Id of the slide
indexwill be ignoredintegerOrder of the slides (Starts with 1)


An example scene template:

"scene": { "viewMode": "transparent", "camera": { "fov": 45, "position": { "x": 1231.4, "y": 234.3, "z": 3123.7 }, "quaternion": { "x": 0.9, "y": 0.7, "z": 0.7, "w": 0.23 }, "target": { "objectId": "<GUID>", "position": { "x": 1231.4, "y": 234.3, "z": 3123.7 } } }, "objects": { "selected": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ], "transparent": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ], "hidden": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ] }, "clippingPlane": { "axis": "x", "distance": -123.5, "selected": false }, "topology": [ [ "<nodeId>", "<disciplineId>" ], [ "<nodeId2>", "<disciplineId2>" ] ], "layers": [ { "id": "<GUID>", "divisionTopologyId": "<GUID>", "visible": true, "transparent": false } ] }

Card
labelDescription
 Creates a new slide for a specific slideshow.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
    "name": "My first slide",
    "scene": {
        "viewMode": "transparent",
        "camera": {
            "fov": 45,
            "position": {
                "x": 1231.4,
                "y": 234.3,
                "z": 3123.7
            },
            "quaternion": {
                "x": 0.9,
                "y": 0.7,
                "z": 0.7,
                "w": 0.23
            },
            "target": {
                "objectId": "<GUID>",
                "position": {
                    "x": 1231.4,
                    "y": 234.3,
                    "z": 3123.7
                }
            }
        },
        "objects": {
            "selected": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "transparent": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "hidden": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ]
        },
        "clippingPlane": {
            "axis": "x",
            "distance": -123.5,
            "selected": false
        },
        "topology": [
            [
                "<nodeId>",
                "<disciplineId>"
            ],
            [
                "<nodeId2>",
                "<disciplineId2>"
            ]
        ],
        "layers": [
            {
                "id": "<GUID>",
                "divisionTopologyId": "<GUID>",
                "visible": true,
                "transparent": false
            }
        ]
    }
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 201 Created
Code Block
borderColorRed
titleJSON
langxml
{
    "name": "My first slide",
    "description": null,
    "slideInfo": "",
    "index": 1,
    "scene": {
        "viewMode": "transparent",
        "camera": {
            "fov": 45,
            "position": {
                "x": 1231.4,
                "y": 234.3,
                "z": 3123.7
            },
            "quaternion": {
                "x": 0.9,
                "y": 0.7,
                "z": 0.7,
                "w": 0.23
            },
            "target": {
                "objectId": "<GUID>",
                "position": {
                    "x": 1231.4,
                    "y": 234.3,
                    "z": 3123.7
                }
            }
        },
        "objects": {
            "selected": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "transparent": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "hidden": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ]
        },
        "clippingPlane": {
            "axis": "x",
            "distance": -123.5,
            "selected": false
        },
        "topology": [
            [
                "<nodeId>",
                "<disciplineId>"
            ],
            [
                "<nodeId2>",
                "<disciplineId2>"
            ]
        ],
        "layers": [
            {
                "id": "<GUID>",
                "divisionTopologyId": "<GUID>",
                "visible": true,
                "transparent": false
            }
        ]
    },
    "created": "2014-03-06T09:52:58.4376633Z",
    "author": {
        "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
        "email": "jayaraj.purushothaman@gmail.com",
        "firstname": "Jayaraj",
        "lastname": "Purushothaman",
        "company": "Jay Company",
        "fullname": "Jayaraj Purushothaman",
        "displayname": "Jayaraj Purushothaman [Jay Company]",
        "info": "",
        "gender": "MR",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "Konrad Zuse platz",
            "streetNr": "1",
            "zip": "81829",
            "city": "Munich",
            "country": "Germany"
        },
        "preferedLanguage": "en"
    },
    "id": "60c23ad7-c4b6-4387-b273-1dff2b1dc895"
}

...

Deck of Cards
idbimGetSlideList
Card
labelHTTP Method
 GET
Card
defaulttrue
labelURL / Resource / JSON Structure
 

Resource: slideshows/<slideshow_id>/slides

URLhttps://api-stage.bimplus.net/v2/<team_slug>/slideshows/<slideshow_id>/slides

Examplehttps://api-stage.bimplus.net/v2/bimplus/slideshows/30f4495a-79d7-48e4-8060-8a52350cfcd9/slides

Card
labelDescription
 Get the slide list belonging to a slideshow
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": "My first slide",
        "description": null,
        "slideInfo": "",
        "index": 1,
        "scene": {
            "viewMode": "transparent",
            "camera": {
                "fov": 45,
                "position": {
                    "x": 1231.4,
                    "y": 234.3,
                    "z": 3123.7
                },
                "quaternion": {
                    "x": 0.9,
                    "y": 0.7,
                    "z": 0.7,
                    "w": 0.23
                },
                "target": {
                    "objectId": "<GUID>",
                    "position": {
                        "x": 1231.4,
                        "y": 234.3,
                        "z": 3123.7
                    }
                }
            },
            "objects": {
                "selected": [
                    0,
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    7,
                    8,
                    9
                ],
                "transparent": [
                    0,
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    7,
                    8,
                    9
                ],
                "hidden": [
                    0,
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    7,
                    8,
                    9
                ]
            },
            "clippingPlane": {
                "axis": "x",
                "distance": -123.5,
                "selected": false
            },
            "topology": [
                [
                    "<nodeId>",
                    "<disciplineId>"
                ],
                [
                    "<nodeId2>",
                    "<disciplineId2>"
                ]
            ],
            "layers": [
                {
                    "id": "<GUID>",
                    "divisionTopologyId": "<GUID>",
                    "visible": true,
                    "transparent": false
                }
            ]
        },
        "created": "2014-03-06T09:52:58",
        "author": {
            "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
            "email": "jayaraj.purushothaman@gmail.com",
            "firstname": "Jayaraj",
            "lastname": "Purushothaman",
            "company": "Jay Company",
            "fullname": "Jayaraj Purushothaman",
            "displayname": "Jayaraj Purushothaman [Jay Company]",
            "info": "",
            "gender": "MR",
            "phoneWork": "",
            "phoneHome": "",
            "fax": "",
            "mobile": "",
            "birthDate": "0000-00-00",
            "address": {
                "street": "Konrad Zuse platz",
                "streetNr": "1",
                "zip": "81829",
                "city": "Munich",
                "country": "Germany"
            },
            "preferedLanguage": "en"
        },
        "id": "60c23ad7-c4b6-4387-b273-1dff2b1dc895"
    }
]

...

Deck of Cards
idbimGetSlideDetails
Card
labelHTTP Method
 GET
Card
defaulttrue
labelURL / Resource / JSON Structure
 Resource: slides/<slide_id>

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

Examplehttps://api-stage.bimplus.net/v2/bimplus/slides/60c23ad7-c4b6-4387-b273-1dff2b1dc895

Card
labelDescription
 Get the details of a particular slide 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": "My first slide",
    "description": null,
    "slideInfo": "",
    "index": 1,
    "scene": {
        "viewMode": "transparent",
        "camera": {
            "fov": 45,
            "position": {
                "x": 1231.4,
                "y": 234.3,
                "z": 3123.7
            },
            "quaternion": {
                "x": 0.9,
                "y": 0.7,
                "z": 0.7,
                "w": 0.23
            },
            "target": {
                "objectId": "<GUID>",
                "position": {
                    "x": 1231.4,
                    "y": 234.3,
                    "z": 3123.7
                }
            }
        },
        "objects": {
            "selected": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "transparent": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ],
            "hidden": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ]
        },
        "clippingPlane": {
            "axis": "x",
            "distance": -123.5,
            "selected": false
        },
        "topology": [
            [
                "<nodeId>",
                "<disciplineId>"
            ],
            [
                "<nodeId2>",
                "<disciplineId2>"
            ]
        ],
        "layers": [
            {
                "id": "<GUID>",
                "divisionTopologyId": "<GUID>",
                "visible": true,
                "transparent": false
            }
        ]
    },
    "created": "2014-03-06T09:52:58",
    "author": {
        "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
        "email": "jayaraj.purushothaman@gmail.com",
        "firstname": "Jayaraj",
        "lastname": "Purushothaman",
        "company": "Jay Company",
        "fullname": "Jayaraj Purushothaman",
        "displayname": "Jayaraj Purushothaman [Jay Company]",
        "info": "",
        "gender": "MR",
        "phoneWork": "",
        "phoneHome": "",
        "fax": "",
        "mobile": "",
        "birthDate": "0000-00-00",
        "address": {
            "street": "Konrad Zuse platz",
            "streetNr": "1",
            "zip": "81829",
            "city": "Munich",
            "country": "Germany"
        },
        "preferedLanguage": "en"
    },
    "id": "60c23ad7-c4b6-4387-b273-1dff2b1dc895"
}

...

Deck of Cards
idbimUpdateSlide
Card
labelHTTP Method
 PUT
Card
defaulttrue
labelURL / Resource / JSON Structure
 Resource: slides/<slide_id>

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

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

JSON Structure

Name

Mandatory / Optional

Type

Description

name

optional

string

Name of the slideshow

descriptionoptionalstringDescription of the slideshow
projectIdoptionalstringThe id of the project to which the slideshow belongs
authorwill be ignoredobject (user)Information about the user who has created the slideshow
createdwill be ignoredstring (date)Creation date of the slideshow
idwill be ignoredstring (id)Id of the slideshow
indexoptionalintegerOrder of the slide (Starts with 1)
Card
labelDescription
 Update a specific slideshow using its id.
Card
labelRequest
Code Block
borderColorGreen
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
titleJSON
langxml
{
    "projectId": "5cd37c77-d341-4ab2-9f0d-44467955b218",
    "name": "Updating my first slide",
    "description": null,
    "author": {
        "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed"
    }
}
Card
labelResponse
Code Block
borderColorGreen
titleStatus
langxml
Status: 200 OK
Code Block
borderColorRed
titleJSON
langxml
{
    "projectId": "5cd37c77-d341-4ab2-9f0d-44467955b218",
    "name": "Updating my first slideshow",
    "description": null,
    "author": {
        "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
        "email": null,
        "firstname": null,
        "lastname": null,
        "company": null,
        "fullname": "",
        "displayname": null,
        "info": null,
        "gender": null,
        "phoneWork": null,
        "phoneHome": null,
        "fax": null,
        "mobile": null,
        "birthDate": null,
        "address": {
            "street": "",
            "streetNr": "",
            "zip": "",
            "city": "",
            "country": ""
        },
        "preferedLanguage": null
    },
    "created": "0001-01-01T00:00:00",
    "id": "ff375edf-5e8c-4b68-a4a1-fec6b943e7d8"
}

...