Skip to main content
请求

curl --location 'https://openapi.gs-robot.com/openapi/v3/schedules/plans/simple/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
"clientTime": 1760328396004,
"clientTimeZone": "Asia/Shanghai",
"loopCount": 1,
"mapResourceList": [
{
"floorIndex": 1,
"floorName": "1F",
"mapId": "140bbb83-fe48-4282-be25-c48252b9c660",
"mapName": "Factory 1F",
"mapResourceAreaId": "1",
"mapResourceId": "327594d9-df72-4950-94b2-64e6d02abdfb",
"mapResourceName": "area1",
"mapResourceType": "region",
"robotMapUuid": "140bbb83-fe48-4282-be25-c48252b9c660"
}
],
"planExecuteType": 2,
"planRepeatType": 0,
"planRepeatWeekly": [
1,
3,
5
],
"planStartDate": "2026-08-29",
"planStartTime": "10:30",
"planStopDate": "2099-12-31",
"planStopTime": "",
"robotSn": "TEST00-0000-000-B088",
"siteId": "site-1",
"siteMode": 0,
"taskAdvanceConfig": {
"autoPlanning": true,
"coverageMode": "standard",
"tempTaskPriority": false
},
"taskName": "Simple schedule",
"workMode": {
"mode": "wash",
"strength": "middle",
"subType": "wash",
"type": 0
}
}'

版本限制:本接口仅支持 AIO1.6 及以上软件版本。

注意事项

  • workMode.mode 必须使用机器人可用的工作模式机器码,仅允许小写字母、数字和下划线。
  • planStartDate、planStopDate 和时间字段会按 clientTimeZone 校验;开始日期不能早于当前日期,结束日期不能早于开始日期,结束时间必须晚于开始时间。
  • 地图资源、WorkMode 和日期时间校验在调用下游前执行。对应的业务错误码包括 230004(资源不存在)、230005(WorkMode 不匹配)、230011(日期无效)、230012(时间无效)和 230013(开始日期已过)。
  • 除成功码 0 外,失败响应使用六位 code。
输出

{
"code": 0,
"data": {},
"msg": "success"
}