接口说明

API接口目前测试中
只需要1个关键参数,设备SN(可在设备详情页面最下面看到,注意复制时避免空格),就可以向设备执行下列接口。
调用url:http://devapi.genicsoft.com+接口地址

接口概览

接口名称 请求方式 接口地址 功能描述
发送播放URL POST /sendPlayUrl 向设备发送音频URL进行播放(仅限mp3格式)
发送播放文本 POST /sendPlayText 向设备发送文本进行语音播放

接口详情

5. 发送播放URL

POST /sendPlayUrl

功能描述: 向设备发送音频URL进行播放

请求参数:

参数名 类型 必填 描述
sn string 设备序列号
url string 音频URL地址

响应示例:

{
  "status": "sent",
  "to": "目标地址",
  "message": "发送的消息内容"
}

6. 发送播放文本

POST /sendPlayText

功能描述: 向设备发送文本进行语音播放

请求参数:

参数名 类型 必填 描述
sn string 设备序列号
text string 要播放的文本内容

响应示例:

{
  "status": "sent",
  "to": "目标地址",
  "message": "发送的消息内容"
}

注意事项

  • 所有接口均需要设备序列号(sn)作为标识
  • 发送到设备的文本内容会自动加密处理
  • 发送播放文本时,文本长度超过100个字符会被自动截断

错误代码

错误代码 描述
404 用户/设备未找到
500 服务器内部错误或Redis操作超时