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

定时任务

GET 定时播报

POST 定时播报

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

请求参数

名称 位置 类型 必选 说明
id query string 云音箱SN编号
version query integer version/版本
token query string none
message query string 播报内容
m query integer 0:删除定时任务,1:创建定时任务
at query string 任务执行时间 10位时间戳
task_id query string 创建定时任务成功后返回的任务ID,删除时必传

返回示例

成功

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

返回结果

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

返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» errcode integer true none none
» errmsg string true none none
» detail object true none none
»» task_id string true none none

你可能感兴趣的:(定时播报,定时提醒,无人茶室,到时提醒)