博瑞智能云音箱云喇叭API开发定时播报文档（2023-4-5）

文章列表

定时任务

POST /task.php

Body 请求参数

message: string
m: 0
at: "{% mock 'timestamp'|number(+10) %}"
task_id: string
id: "{{speakerid}}"
token: "{{token}}"
version: "{{version}}"

名称	位置	类型	必选	说明
body	body	object	否	none
» message	body	string	是	播报内容
» m	body	integer	是	0：删除定时任务，1：创建定时任务
» at	body	string	是	任务执行时间 10位时间戳
» task_id	body	string	否	创建定时任务成功后返回的任务ID，删除时必传
» id	body	string	否	SPEAKERID ，指该云音箱标签上的的 SN/ID
» token	body	string	是	代理商的 token, 预先通过安全渠道分配，使得代理商对该云音箱有操作权限
» version	body	string	是	按各型号标注的VERSION版本，由用户配置时选择，预留1-9供选择

返回示例

成功

{"errcode": 0,"errmsg": "success","detail": {"task_id": "52b83e069770e05ba0a640e6ae2a010a"}
}

{"errcode": -1,"errmsg": "创建失败,任务时间至少10秒以后","detail": null
}

{"errcode": -1,"errmsg": "删除失败,task_id不正确","detail": null
}

{"errcode": 0,"errmsg": "success","detail": null
}

GET /task.php

返回示例

成功

{"errcode": 0,"errmsg": "success","detail": {"task_id": "52b83e069770e05ba0a640e6ae2a010a"}
}

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

状态码 200