API：获取文件转换的构件列表

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

根据构件类型ID、族和族类型获取构件列表

---

请求（Request）

Header

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

Url Parameter

字段	类型	必填	描述	示例
fileId	Number	Y	文件ID	…
specialty	String	N	专业	…
floor	String	N	楼层	…
categoryId	String	N	构件分类ID	…
family	String	N	族	…
familyType	String	N	族类型	…

Request Body

无

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

---

响应（Response）

HTTP STATUS

200

成功返回

{
    "code":"success",
    "message":null,
    "data":[
        "644851",
        "644853",
        "644855",
        "644857",
        "644859",
        "644861",
        "644863",
        "644865",
        "644867",
        "644869",
        "644871",
        "644873",
        "644875",
        "644877",
        "644879",
        "644881",
        "644883",
        "644885",
        "644887",
        "644889"
    ]
}

字段	类型	描述	示例
data	String[]	符合条件的构件ID列表	…

失败返回

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

错误码

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