POST /api/v1/locations
请求体
{
"regionId": 1,
"name": "花架上层",
"lightLevel": 3,
"order": 0
}
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
regionId |
number |
是 | — | 所属区域 ID |
name |
string |
是 | 1-24 字符 | 位置名称 |
lightLevel |
number |
否 | 0-4 | 光照强度等级 |
order |
number |
否 | — | 排序号，默认 0 |
响应
{
"code": 200,
"message": "success",
"data": {
"id": 1,
"name": "花架上层",
"lightLevel": 3,
"createdAt": 1747123456789
},
"requestId": "...",
"timestamp": 1747123456789
}
| 字段 | 类型 | 说明 |
|---|---|---|
id |
number |
位置 ID |
name |
string |
位置名称 |
lightLevel |
number |
光照强度（0-4），未设置时不出现此字段 |
createdAt |
number |
创建时间（13 位毫秒级 Unix 时间戳） |