GET /api/v1/plants?page=0&size=20
查询参数
| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
page |
number |
否 | 0 | 页码 |
size |
number |
否 | 20 | 每页数量 |
locationId |
number |
否 | — | 按位置过滤 |
regionId |
number |
否 | — | 按区域过滤(取该区域下全部 location);与 locationId 同时给时 locationId 优先 |
响应
{
"code": 200,
"message": "success",
"data": {
"items": [ ... ],
"page": 0,
"size": 20,
"total": 42
},
"requestId": "...",
"timestamp": 1747123456789
}
items 元素结构与 创建植物 一致(含 species / location / tags / covers 全面嵌套)。
无位置植物(其位置被删除后解绑,
location为null)仅在不传locationId/regionId时返回;按位置或区域过滤时自动排除。
归属不符:
locationId→ 4043005;regionId→ 4043006。