device_register

通过 API 方式注册新设备信息。

接口信息

URL	https://api.xxx.com/device/register
请求方式	POST
权限说明	设备注册

请求参数

Header

字段名称	类型	必选	说明
Authorization	string	是	Bearer ${accessToken} 获取方式参考获取授权页面

Body

字段名称	类型	必选	说明
vendorId	string	是	厂商唯一标识，运营平台创建分配 （获取方式）
appId	string	是	应用空间唯一标识，运营平台创建分配 （获取方式）
type	string	是	设备类型。取值： PHYSICAL_ROBOT，生产设备 APP_ROBOT，测试设备
name	string	是	设备名称
deviceId	string	是	设备唯一标识。厂商需要保证设备ID唯一
deviceModel	string	否	设备型号
timbreId	string	否	音色 id 运营平台分配
desc	string	否	描述信息

请求示例

curl -X "POST" "https://api.xxx.com/device/register" \
     -H 'Authorization: Bearer 123456' \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "appId": 1,
  "deviceId": "1",
  "type": "APP_ROBOT",
  "vendorId": 15,
  "name": "测试"
}'

响应结果

参数

字段名称	类型	必选	说明
state	string	是	返回状态。取值： SUCCESS 成功; FAILURE 失败
code	string	是	返回码
result	string	是	描述信息
data	string	是	对话机器人ID , 用于后续对话 botId

响应示例

{
  "state": "SUCCESS",
  "code": "0000",
  "result": "创建成功",
  "data": "0428f41d89fc436b8d63a529cf7141a7"
}