PUT /api/v1/regions/order
一次性重排当前用户的全部区域。客户端在拖拽后提交新的完整顺序,服务器据此重新分配连续的内部排序号(1..N);响应列表按新顺序返回,排序由数组位置体现。
请求体
{
"orderedIds": [3, 1, 2, 5]
}
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
orderedIds |
number[] |
是 | 非空 | 新顺序下的区域 ID 列表,须为当前用户全部区域的完整排列 |
响应
{
"code": 200,
"message": "success",
"data": [
{
"id": 3,
"name": "阳台",
"longitude": 121.4737,
"latitude": 31.2304,
"locations": [
{
"id": 1,
"name": "花架上层",
"lightLevel": 3,
"createdAt": 1747123456789
}
],
"createdAt": 1747123456789
},
{
"id": 1,
"name": "客厅",
"locations": [],
"createdAt": 1747123456789
},
{
"id": 2,
"name": "卧室",
"locations": [],
"createdAt": 1747123456789
},
{
"id": 5,
"name": "书房",
"locations": [],
"createdAt": 1747123456789
}
],
"requestId": "...",
"timestamp": 1747123456789
}
返回当前用户所有区域,结构与 查询区域列表 一致,按新顺序排列并附带每个区域下的位置列表。未设置经纬度的区域不会出现
longitude/latitude 字段。
说明
orderedIds 必须是当前用户全部(未删除)区域的完整排列:缺失、多余、重复或混入他人区域 ID 均不允许。orderedIds 或为空数组 → 400(1101 VALIDATION_FAILED)。orderedIds 非完整排列(缺失、多余、重复或包含不属于当前用户的区域 ID)→ 409(4203 REGION_REORDER_INVALID)。