API：获取文件转换的构件属性

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

根据fileId、elementId获取构件属性

---

请求（Request）

Header

key	value	示例
Authorization	bearer {accessToken}	bearer xxxx-xxxx-xxxx-xxxx
Content-Type	application/json	…

Url Parameter

字段	类型	必填	描述	示例
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/element/property?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	属性单位	m²

失败返回

{
    "code": "authentication.failed",
    "message": "Token was not recognized."
}

错误码

code	说明
system.error	BIMFACE系统异常
authentication.failed	API访问合法性校验失败
data.not.found	找不到数据