diff --git a/changelogs/2026-03/26_0905_xmm_detail_fields.md b/changelogs/2026-03/26_0905_xmm_detail_fields.md index 22dc9be..d54c917 100644 --- a/changelogs/2026-03/26_0905_xmm_detail_fields.md +++ b/changelogs/2026-03/26_0905_xmm_detail_fields.md @@ -281,3 +281,30 @@ ``` 如果没有可报名团期,`priceTiers` 返回 null。 + +--- + +## 十、人员证书上传说明 + +**上传流程**:使用通用文件上传接口,和上传其他图片一样。 + +**步骤**: +1. `POST /file/upload/token` → 获取预签名URL +```json +{ "fileName": "急救证书.jpg", "bizType": "staff" } +``` +2. 用返回的预签名URL上传文件到OSS +3. `POST /file/upload/confirm` → 确认上传,拿到最终URL +4. 将URL填入 `certificates[].url` + +**保存人员时传 certificates 字段**: +```json +{ + "certificates": [ + { "tag": "急救证书", "url": "https://xxx/cert1.jpg" }, + { "tag": "导游证", "url": "https://xxx/cert2.jpg" } + ] +} +``` + +每项 `tag` 和 `url` 必须同时填,缺一报错。旧字段 `certificateTags`/`certificateUrls` 仍可用但建议迁移。