POST /api/v1/plant-journals
请求体
{
"type": 1,
"eventTime": 1747123456789,
"properties": "{\"waterAmountMl\":500}",
"remark": "盆土表面干了才浇的",
"plantIds": [1, 5],
"media": [
400
]
}
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
type |
number |
否 | 见 JournalType 枚举 | 养护类型，默认 0（未指定） |
eventTime |
number |
否 | 13 位毫秒级 Unix 时间戳 | 养护时间，默认当前时间 |
properties |
string |
否 | 合法 JSON String（非法 → 400） | 养护属性（JSON String） |
remark |
string |
否 | 最大 255 字符 | 备注 |
plantIds |
array |
是 | 至少一个元素（空集 → 400） | 关联的植物 ID 列表 |
media |
array |
否 | — | 附件 mediaId 列表，位置即顺序（重复/空值自动忽略） |
响应
{
"code": 200,
"message": "success",
"data": {
"id": 1,
"type": 1,
"eventTime": 1747123456789,
"properties": "{\"waterAmountMl\":500}",
"remark": "盆土表面干了才浇的",
"plantIds": [1, 5],
"media": [
{
"id": 400,
"url": "https://cdn.floriax.cn/media/1/2026/05/14/uuid3.jpg"
}
],
"createdAt": 1747123456789
},
"requestId": "...",
"timestamp": 1747123456789
}
| 字段 | 类型 | 说明 |
|---|---|---|
id |
number |
记录 ID |
type |
number |
养护类型，见 JournalType 枚举 |
eventTime |
number |
养护时间（13 位毫秒级 Unix 时间戳） |
properties |
string |
养护属性（JSON String），未设置时不出现此字段 |
remark |
string |
备注，未设置时不出现此字段 |
plantIds |
array |
关联的植物 ID 列表 |
media |
array |
附件列表，按排序号升序，每项为 MediaSummary（id、url） |
createdAt |
number |
记录创建时间（13 位毫秒级 Unix 时间戳） |