获取集成模型的构件属性_文档_BIMFACE_BIM应用二次开发平台

API:获取集成模型的构件属性

GET https://api.bimface.com/data/integration/element/property

集成的模型的构件属性


请求(Request)

Header
key value 示例
Authorization bearer {accessToken} bearer xxxx-xxxx-xxxx-xxxx
Content-Type application/json
Url Parameter
字段 类型 必填 描述 示例
integrateId Number Y 集成ID
fileId Number Y 文件ID
elementId String Y 构件ID
Request Body

curl -X GET 
-H "Content-Type: application/json" 
-H "Authorization: bearer <your accessToken>" 
"https://api.bimface.com/data/integration/element/property?integrateId=<your integrateId>&fileId=<your fileId>&elementId=<your elementId>"

响应(Response)

HTTP STATUS

200

成功返回
{
    "code": "success",
    "message": null,
    "data": {
        "elementId": "9876123492",
        "name": "TP10(Low-e)+12A+TP10中空蓝灰色玻璃",
        "boundingBox": {
            "min": {
                "x": 20174.197245435877,
                "y": 60867.47840650141,
                "z": 2946.249999999989
            },
            "max": {
                "x": 20824.197245435877,
                "y": 61517.47840650142,
                "z": 3046.249999999989
            }
        },
        "properties": [
            {
                "group": "基本属性",
                "items": [
                    {
                        "key": "specialty",
                        "value": "建筑",
                        "unit": ""
                    },
                    {
                        "key": "floor",
                        "value": "1F/-0.05",
                        "unit": ""
                    },
                    {
                        "key": "categoryId",
                        "value": "-2001300",
                        "unit": ""
                    },
                    {
                        "key": "categoryName",
                        "value": "结构基础",
                        "unit": ""
                    },
                    {
                        "key": "family",
                        "value": "槽式电缆桥架水平三通",
                        "unit": ""
                    },
                    {
                        "key": "familyType",
                        "value": "",
                        "unit": ""
                    }
                ]
            },
            {
                "group": "尺寸标注",
                "items": [
                    {
                        "key": "面积",
                        "unit": "m²",
                        "value": "3"
                    },
                    {
                        "key": "高度",
                        "unit": "mm",
                        "value": "1800,0"
                    },
                    {
                        "key": "宽度",
                        "unit": "mm",
                        "value": "1800,0"
                    }
                ]
            },
            {
                "group": "标识数据",
                "items": [
                    {
                        "key": "图像",
                        "unit": "",
                        "value": ""
                    },
                    {
                        "key": "注释",
                        "unit": "",
                        "value": ""
                    },
                    {
                        "key": "标记",
                        "unit": "",
                        "value": ""
                    }
                ]
            },
            {
                "group": "阶段化",
                "items": [
                    {
                        "key": "拆除的阶段",
                        "unit": "",
                        "value": "无"
                    },
                    {
                        "key": "创建的阶段",
                        "unit": "",
                        "value": "新构造"
                    }
                ]
            }
        ]
    }
}
字段 类型 描述 示例
elementId String 构件ID 9876123492
name String 构件名称 TP10(Low-e)+12A+TP10中空蓝灰色玻璃
boundingBox BoundingBox 包围盒
boundingBox.min Min 近端坐标
boundingBox.max Max 远端坐标
boundingBox.min(max).x Number X轴
boundingBox.min(max).y Number Y轴
boundingBox.min(max).z Number Z轴
properties Property[] 属性列表
properties.group String 属性分组 基本属性
properties.items Item[] 属性项列表
properties.items.key String 属性名称 面积
properties.items.value Object 属性值 3
properties.items.unit String 属性单位
失败返回
{
    "code": "authentication.failed",
    "message": "Token was not recognized."
}
错误码
code 说明
system.error BIMFACE系统异常
authentication.failed API访问合法性校验失败
data.not.found 找不到数据