新增设备
概述
提供向指定游戏店铺添加游戏设备的服务，支持设备信息录入和自动命名逻辑。
- 智能设备命名
- 当设备名称为空时，自动组合授权名称-设备SN作为设备名称
- 示例："授权测试1-PA9410MGJ0000000G"
- 严格类型校验
- 设备类型必须来自“查询支持的设备类型”接口返回的有效值
- 拒绝无效类型（如"PICO 4 Ultra Enterprise"需完全匹配）
- 店铺关联验证
- 校验storeId是否存在且有效
- 自动记录设备所属店铺关系
接口地址
http://api.xvista.cc:9999/largespace/public/v1/add/device
请求方法
- POST
请求参数
url参数：
http://api.xvista.cc:9999/largespace/public/v1/add/device?access_token=00000000000000
| 参数 | 必选 | 值 |
|---|---|---|
| access_token | 是 | 通过Secret Key获取的access_token，参考"获取access_token" |
Body参数：
{
"name":"",
"sn":"PA9410MGJ0000000G",
"type":"PICO 4 Ultra Enterprise",
"storeId":"000000",
"notes":""
}
| 参数 | 必选 | 类型 | 值 |
|---|---|---|---|
| name | 否 | string | 设备名称 |
| sn | 是 | string | 设备PicoSN |
| type | 是 | string | 设备类型，可通过“查询支持的设备类型”接口验证，需全字匹配 |
| storeId | 是 | string | 店铺ID，新增店铺成功后返回，或通过“查询名下所有店铺”接口查询 |
| notes | 是 | string | 备注 |
返回示例
成功返回：
{
"code": 1,
"message": "success",
"data": {
"name": "授权测试1-PA9410MGJ0000000G",
"sn": "PA9410MGJ0000000G"
},
"timestamp": 1750094329956,
"executeTime": 167
}
| 参数 | 类型 | 值 |
|---|---|---|
| name | string | 成功添加的设备名 |
| sn | string | 成功添加的SN |
[!TIP] 为减少会话，尽量避免进行其他操作前先查所有设备信息，新增成功后返回的设备SN，请注意保存！
除"data"外的其他参数，可以在“通用说明-统一请求响应”中找到说明
错误返回：
| code | message | 解释 |
|---|---|---|
| 400 | 设备已存在 | 名下已存在相同SN的设备 |
| 400 | 设备类型不存在 | 传入的设备类型不正确，请使用查询支持的设备类型接口获取所有可用设备类型 |
| 400 | 店铺不存在 | 传入的店铺ID不正确，新增店铺成功后返回，请注意保存，可通过“查询名下所有店铺”接口查询 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注
- 暂无