任务管理

获取站点信息

GET /openapi/v2alpha1/robots/{robotId}/getSiteInfo

查询指定机器人所关联站点的完整结构信息，包括站点名称、建筑物列表、楼层列表及各楼层地图。

路径参数

响应参数

// 响应示例
{
  "id": "site_001",
  "name": "总部大楼",
  "buildings": [
    {
      "name": "A栋",
      "floorNum": 3,
      "uuid": "bld-uuid-001",
      "floors": [
        {
          "index": 1,
          "name": "1F",
          "maps": []
        }
      ]
    }
  ]
}

提交站点临时任务

POST /openapi/v2/robot/tasks/temp/withSite

向指定机器人下发基于站点的临时清扫任务。需要提供站点 ID、楼层配置和任务配置等信息。

请求参数

响应参数

// 请求示例
{
  "serialNumber": "GS101-00A0-A7L-0000",
  "cleaningMode": "auto",
  "loopCount": 1,
  "siteId": "site_001",
  "taskName": "日常清扫任务",
  "floors": [],
  "tasks": []
}

// 响应示例
{
  "name": "cmd-resource-001",
  "state": "WAITING",
  "taskQueueId": "tq-001"
}

提交无站点临时任务

POST /openapi/v2/robot/tasks/temp/withoutSite

向指定机器人下发不依赖站点的临时清扫任务。通过 mapName 直接指定地图，适用于未配置站点或需要快速下发单地图任务的场景。

请求参数

响应参数

// 请求示例
{
  "productId": "GS101-00A0-A7L-0000",
  "tempTaskCommand": {
    "cleaningMode": "auto",
    "loop": false,
    "loopCount": 1,
    "taskName": "快速清扫",
    "mapName": "floor_1f_map",
    "startParam": []
  }
}

// 响应示例
{
  "name": "cmd-resource-002",
  "state": "WAITING",
  "rawCommandType": "send_temp_task"
}

最佳实践