GET /api/v1/plant-species?categoryId=1&keywords=monstera&page=0&size=20
查询参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
categoryId |
number |
否 | 按分类 ID 过滤 |
keywords |
string |
否 | 关键词搜索：空格分隔多个词、全部命中；匹配俗名/学名/属/科，大小写不敏感 |
page |
number |
否 | 页码（默认 0） |
size |
number |
否 | 每页数量（默认 20） |
响应
{
"code": 200,
"message": "success",
"data": {
"items": [
{
"id": 1,
"commonName": "龟背竹",
"scientificName": "Monstera deliciosa",
"genus": "Monstera",
"speciesEpithet": "deliciosa",
"family": "Araceae",
"description": "...",
"coverUrl": "https://api.floriax.cn/api/v1/media/202605/a1b2c3d4e5f6.png",
"careDifficulty": 1,
"lightRequirement": 2,
"wateringFrequencyGuide": "7-10天/次",
"humidityRequirement": "喜欢高湿度环境",
"toxicityLevel": 3,
"categories": [
{
"id": 1,
"name": "室内植物"
},
{ "id": 2, "name": "观叶植物" }
]
}
],
"page": 0,
"size": 20,
"total": 150
},
"requestId": "...",
"timestamp": 1747123456789
}