# 统计目录下脑图数量 - CountMindmapTotal #### 功能介绍 根据查询条件统计当前特性目录下的脑图数量 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v1/{project_id}/mindmaps/mindmap-total 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目的32位uuid，项目唯一标识，通过[获取CodeArts项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4005.html)接口查询项目列表获取。 **取值范围：** 字符串长度32。 **默认取值：** 无。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 无。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | params | 是 | [CountMindmapTotalParam] object | **参数解释：** 统计脑图数量参数对象 | 表4CountMindmapTotalParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | parent_folder_id_collection | 否 | Array of strings | **参数解释：** ID集合 | | project_type | 是 | String | **参数解释：** 项目类型 **取值范围**： - ipd - scrum - xboard | | folder_root_id | 是 | String | **参数解释：** 所属目录的根目录ID **取值范围：** 1.-1：特性目录其他目录 2.requirement_root_id：需求根目录 3.feature_root_id：特性根目录 **默认取值：** 无 **获取方法：** POST /v5/features/{feature_uri}/children接口返回的uri字段 | | branch_uri | 是 | String | **参数解释：** 分支uri **取值范围：** 大小写字母、数字。 长度限制1-34位 **默认取值：** 无 **获取方法：** GET /GT3KServer/v4/branches接口返回值中的uri字段。 | | iterator_uri | 是 | String | **参数解释：** 计划uri **取值范围：** 大小写字母、数字。 长度限制0-34位 **默认取值：** 无 **获取方法：** GET /v4/iterators/{iterator_uri}接口返回值中的uri字段。 | | is_master | 是 | Integer | **参数解释：** 是否基线 **取值范围：** - 0，表示非基线。 - 1，表示是基线。 | | upward_recursion | 是 | Boolean | **参数解释：** 是否向上卷积 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 错误码 **取值范围：** 大小写字母、数字。 长度限制0到20位 | | data | Map\ | **参数解释：** 返回体 **取值范围：** 不涉及 | | message | String | **参数解释：** 错误信息 **取值范围：** 大小写字母、数字、符号、中文。 长度限制0到1000位 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 接口调用错误码。 **取值范围：** 大小写字母a-z、A-Z和数字0-9 长度限制0到20位字符 | | data | String | **参数解释：** 接口调用返回体 **取值范围：** JSON字符串格式 | | message | String | **参数解释：** 接口调用错误信息 **取值范围：** 大小写字母、数字、符号、中文。 长度限制0到1000位字符 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 接口调用错误码。 **取值范围：** 大小写字母a-z、A-Z和数字0-9 长度限制0到20位字符 | | data | String | **参数解释：** 接口调用返回体 **取值范围：** JSON字符串格式 | | message | String | **参数解释：** 接口调用错误信息 **取值范围：** 大小写字母、数字、符号、中文。 长度限制0到1000位字符 | #### 请求示例 统计目录下脑图数量 ``` post https://{endpoint}/v1/b94c9a6947a44597891e0a7362e7383f/mindmaps/mindmap-total { "params" : { "parent_folder_id_collection" : [ ], "project_type" : "scrum", "folder_root_id" : "feature_root_id", "branch_uri" : "v92t00010a9h5c3e", "iterator_uri" : "", "is_master" : 1, "upward_recursion" : false } } ``` #### 响应示例 **状态码：200** OK ``` { "code" : "success", "data" : { "feature_root_id" : 15, "-1" : 4, "v92s00010etsb5ij" : 0 }, "message" : null } ``` **状态码：400** Bad Request ``` { "error_code" : "TESTMIND.00021882", "error_msg" : "分支、计划id长度不合法，请稍后重试" } ``` **状态码：401** Unauthorized ``` { "error_code" : "DEV.00000003", "error_msg" : "认证信息过期" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。