# 方形件-电子锯 #### 功能介绍 创建二维切割-方形件-电子锯任务， 该接口为异步操作，返回任务ID，任务的状态及结果请通过查询任务详情接口获取。 #### URI POST /v2/{project_id}/optverse/regular-plate/tasks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 用户项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-optverse/optverse_04_0026.html)。 | #### 请求参数 二维切割前的原材料请求参数如[表4]所示。 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | 该字段填为"application/json"。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | input_json | 是 | object | 任务输入信息，json格式，具体数据结构参见[regularPlateInputJson]。 | 表4regularPlateInputJson | 参数 | 是否必须 | 参数类型 | 说明 | |:---|:---|:---|:---| | plate_id | 是 | Int | 原材料ID | | plate_length | 是 | Float | 原材料长 | | plate_width | 是 | Float | 原材料宽 | | plate_thick | 是 | Float | 原材料厚度 | | plate_material | 是 | String | 原材料制作材料 | | plate_grain | 是 | Bool | 原材料是否有纹路 | | plate_num | 是 | Int | 原材料数量 | | is_offcut | 否 | Bool | 是否为余料 | | plate_cost | 否 | Float | 原材料成本 | 二维切割后的成品请求参数如[表5]所示。 表5成品请求Body参数说明 | 参数 | 是否必须 | 参数类型 | 说明 | |:---|:---|:---|:---| | item_id | 是 | int | 成品ID | | item_length | 是 | Float | 成品长 | | item_width | 是 | Float | 成品宽 | | item_thick | 是 | Float | 成品厚度 | | item_num | 是 | Int | 成品数量 | | item_turn | 是 | Bool | 成品是否可以旋转（无纹路：true,有纹路：false） | | item_material | 是 | String | 成品材料 | | item_name | 是 | String | 成品名称 | | is_substitute | 否 | Bool | 是否为替补板 | | label_info | 是(键值对内的信息可随意增加与删减) | map\ | 打印标签信息的键值对组合 | 二维切割条件参数的请求参数如[表6]所示。 表6切割条件参数的请求Body参数说明 | 参数 | 是否必须 | 参数类型 | 说明 | |:---|:---|:---|:---| | kerf_horizontal | 是 | Float | 横向锯刀宽度 | | kerf_vertical | 是 | Float | 纵向锯刀宽度 | | plate_trim_horizontal | 是 | Float | 原材料横向修边量 | | plate_trim_vertical | 是 | Float | 原材料纵向修边量 | | item_forward_trim | 是 | Float | 再分锯切前向修边量 | | item_backward_trim | 是 | Float | 再分锯切后部修边量 | | first_cut_direction | 是 | Int | 进料方向（横向0，纵向1，任意方向2） | | max_stack_height | 是 | Float | 最大叠板高度 | | calculate_time | 是 | Int | 算法的最长计算时间 | | offcut_length | 否 | Float | 余料长度下限 | | offcut_width | 否 | Float | 余料宽度下限 | | offcut_area | 否 | Float | 余料面积下限 | | time_cost | 否 | Float | 每小时的锯切时间成本 | | max_cut_stage_num | 否 | Int | 开始切割后，同一个方向上的切割，统计为一次，需在设置的转板次数内，将大板切割完毕 | | min_stack_utilization | 否 | Float | 最小的叠板利用率 | | item_sort_location | 否 | Bool | 长条板件中部件的放置顺序，true最大部件放在左侧，false最大部件放在右侧 | | item_num_limit | 否 | Int | 锯切图上的小板种类数量限制 | #### 请求示例 ``` POST https://{endpoint}/v2/{project_id}/optverse/regular-plate/tasks Request Header: Content-Type: application/json;charset=utf-8 Auth-Token: Body: { "input_json": { "items": [ { "item_id": 0, "item_material": "18mm金丝白橡零度木刺刨花板E0", "item_length": 60.0, "item_width": 553.0, "item_turn": false, "item_num": 1, "item_name": "F-补板/立档条", "item_thick": 18, "label_info": {} } ], "parameters": [ { "calculate_time": 30, "first_cut_direction": 1, "item_backward_trim": 0.0, "item_forward_trim": 0.0, "kerf_horizontal": 4.4, "kerf_vertical": 4.4, "max_program_num": 2, "max_stack_height": 80, "plate_trim_horizontal": 10.0, "plate_trim_vertical": 10.0 } ], "plates": [ { "plate_grain": true, "plate_id": 0, "plate_length": 2440.0, "plate_material": "18mm金丝白橡零度木刺刨花板E0", "plate_num": 9999, "plate_thick": 18.0, "plate_width": 1220.0 } ] } } ``` #### 响应示例 **成功响应示例** ``` { "task_id": "40axxxx-701a-47cf-8b56-648xxxxxxd25, "create_time": "2025-08-13T08:58:51.479Z", "estimated_start_time": null, "status": "Pending" } ``` 参数说明如[表7]所示。 表7响应参数 | 参数 | 参数类型 | 说明 | |:---|:---|:---| | task_id | String | 任务编号。 | | create_time | String | 任务创建时间 | | estimated_start_time | String | 预估开始时间 | | status | String | 任务状态，包括： - Pending：任务等待处理中（排队中） - Running：任务正在运行 - Expired：任务超时 - Failed：任务失败 - Succeeded：任务成功 | **失败响应示例** ``` { "error_code": "optverse.00000006", "error_msg": "Input data validate error: the item material is 18MM_PLATE, item_id is 0： Length and width are larger than plate.\n" } ``` #### 查询任务 该API用于查询并显示方形件-电子锯任务详情 #### URI GET /v2/{project_id}/optverse/regular-plate/tasks/{task_id} #### 请求参数 表8参数说明 | 参数 | 参数类型 | 说明 | |:---|:---|:---| | task_id | String | 任务ID | #### 响应参数 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | 任务编号。 | | input_json | String | 输入数据，当前为null | | status | String | 任务状态，包括： - Pending：任务等待处理中（排队中） - Running：任务正在运行 - Expired：任务超时 - Failed：任务失败 - Succeeded：任务成功 | | progress | String | 返回任务进度 | | output_json | Array of objects | 任务处理结果，json格式，任务状态为finished时携带。具体数据结构参见[regularPlateResultDetail] | | estimated_start_time | String | 预估开始时间 | | start_time | String | 任务开始时间 | | end_time | String | 任务结束时间 | | create_time | String | 任务创建时间 | 表10regularPlateResultDetail | 参数 | 参数类型 | 说明 | |:---|:---|:---| | error_detail | String | 如果运行出错会提示 | | result | Object | 如果运行正常会在该属性内给出结果 | | status | String | 任务状态，包括： - Pending：任务等待处理中（排队中） - Running：任务正在运行 - Expired：任务超时 - Failed：任务失败 - Succeeded：任务成功 | | task_id | String | 任务id | | result_list | Array of objects | 切割方案列表 | | plan_info | Array of objects | 切割方案的统计信息列表 | | cut_file | String | 以字符串形式保存的切割方案文件 | | plan_name | String | 此方案序号（根据参数设置可给出多组方案） | | material_info | String | 统计信息，详情请参见[表11] | | material_name | String | 材料名称 | | problem_id | Int | 按材料划分的问题序列号 | 表11统计信息响应参数说明 | 参数 | 单位 | 参数类型 | 说明 | |:---|:---|:---|:---| | cut_length | 米(m) | float | 切割长度 | | cut_sum | - | Int | 切割刀数 | | cut_time | 分钟(min) | float | 锯切时间 | | item_num | - | Int | 开料件数 | | material | - | String | 材料 | | program_num | - | Int | 锯切图数量 | | run_program_num | - | Int | 运行的锯切图数 | | rate | 百分比(%) | float | 原材料利用率 | | sum_area | 平方米(m^2^) | float | 原材料使用面积 | | sum_cost | - | Float | 锯切成本 | | sum_plate_num | - | Int | 原材料使用数量 | | sum_used_area | 平方米(m^2^) | float | 原材料利用面积 | #### 请求示例 表12参数说明 | 参数 | 参数类型 | 说明 | |:---|:---|:---| | task_id | String | 任务ID | #### 响应示例 响应示例 **成功响应示例** ``` { "result": { "result_list": [ { "cut_file": "", "plan_info": [ { "material_info": { "cut_length": 5.02, "cut_sum": 5, "cut_time": 1.1, "item_num": 2, "material": "18MM_PLATE", "program_num": 1, "rate": 0.02229, "run_program_num": 1, "sum_area": 2.98, "sum_cost": 103.67, "sum_plate_num": 1, "sum_used_area": 0.07 }, "material_name": "18MM_PLATE", "problem_id": 1 } ], "plan_name": "方案1" }, { "cut_file": "", "plan_info": [ { "material_info": { "cut_length": 5.02, "cut_sum": 5, "cut_time": 1.1, "item_num": 2, "material": "18MM_PLATE", "program_num": 1, "rate": 0.02229, "run_program_num": 1, "sum_area": 2.98, "sum_cost": 103.67, "sum_plate_num": 1, "sum_used_area": 0.07 }, "material_name": "18MM_PLATE", "problem_id": 1 } ], "plan_name": "方案2" }, { "cut_file": "", "plan_info": [ { "material_info": { "cut_length": 5.02, "cut_sum": 5, "cut_time": 1.1, "item_num": 2, "material": "18MM_PLATE", "program_num": 1, "rate": 0.02229, "run_program_num": 1, "sum_area": 2.98, "sum_cost": 103.67, "sum_plate_num": 1, "sum_used_area": 0.07 }, "material_name": "18MM_PLATE", "problem_id": 1 } ], "plan_name": "方案3" }, { "cut_file": "", "plan_info": [ { "material_info": { "cut_length": 5.02, "cut_sum": 5, "cut_time": 1.1, "item_num": 2, "material": "18MM_PLATE", "program_num": 1, "rate": 0.02229, "run_program_num": 1, "sum_area": 2.98, "sum_cost": 103.67, "sum_plate_num": 1, "sum_used_area": 0.07 }, "material_name": "18MM_PLATE", "problem_id": 1 } ], "plan_name": "方案4" } ] }, "status": "finished", "task_id": "40axxxxx-701a-47cf-8b56-648xxxxxxx25" } ```