POST /api/v1/regions
请求体
{
"name": "阳台",
"longitude": 121.4737,
"latitude": 31.2304,
"order": 0
}
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
name |
string |
是 | 1-24 字符 | 区域名称 |
longitude |
number |
否 | -180-180 | 经度 |
latitude |
number |
否 | -90-90 | 纬度 |
order |
number |
否 | — | 排序号，默认 0 |
响应
{
"code": 200,
"message": "success",
"data": {
"id": 1,
"name": "阳台",
"longitude": 121.4737,
"latitude": 31.2304,
"locations": [],
"createdAt": 1747123456789
},
"requestId": "...",
"timestamp": 1747123456789
}
| 字段 | 类型 | 说明 |
|---|---|---|
id |
number |
区域 ID |
name |
string |
区域名称 |
longitude |
number |
经度，未设置时不出现此字段 |
latitude |
number |
纬度，未设置时不出现此字段 |
locations |
array |
下属位置列表，按排序号升序，元素含 id、name、lightLevel、createdAt |
createdAt |
number |
创建时间（13 位毫秒级 Unix 时间戳） |