# 发起分析

净空分析通过后端接口发起:

POST https://api.bimface.com/feature-management/v1/spaces/clearance-height-check

发起时,需要首先指定AccessToken (opens new window)

在具备可使用的AccessToken后,需要配置Body参数,指定分析条件。分析条件具体说明可见数据准备 (opens new window)的介绍

现给出示例如下:

{
    "fileId":"123456", //必填,指定需要分析的文件id,也可以是integrateId,两者二选一。
    "name":"这是一个示例", //非必填,指定净空分析名称,限制最大字符数量128,校验非法字符
    "description":"这个示例记录了 123 456 房间的净空分析", //非必填,指定净空分析描述,限制最大字符数量256
    "checkList":[ //必填,分析条件,可依据不同净高要求,指定不同分析条件
        {
            "spaceIdList":["123"], // 必填,参与分析的空间列表
            "selection":{ // 非必填,指定参与分析的构件筛选条件
                "objectData":[{"categoryId": "-2001330"}]
            },
            "option":{
                "targetHeight":"2800", // 必填,指定目标分析高度
                "minIgnoreHeight":"2300", // 非必填,指定最小忽略净高,不对该高度以下的构件参与分析
                "maxIgnoreHeight":"3000",// 非必填,指定最大忽略净高,不对该高度以上的构件参与分析
                "unit":"mm" // 非必填,指定高度单位。若不填默认缺省值为mm
            }
        }
    ]
}

在指定分析条件后,调用接口即可发起分析。完成分析后,可依据接口查询分析结果。