feat: 通知前端Step1接口变更(创建+更新合一)+ payment_type字典恢复
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
750f91d3ab
当前提交
1dd1e3c2ae
@ -0,0 +1,104 @@
|
||||
# 接口变更记录 — 2026-04-13 (重要)
|
||||
|
||||
> **变更类型**:接口路径变更
|
||||
> **影响范围**:创建产品 + Step1基础信息保存
|
||||
> **测试环境已部署**
|
||||
|
||||
---
|
||||
|
||||
## Step1 基础信息保存 — 接口变更
|
||||
|
||||
### 旧接口(已删除,不可用)
|
||||
|
||||
```
|
||||
POST /admin/product/item ← 已删除
|
||||
PUT /admin/product/item/{id}/basic ← 已删除
|
||||
```
|
||||
|
||||
### 新接口(立即使用)
|
||||
|
||||
```
|
||||
POST /admin/product/item/basic
|
||||
```
|
||||
|
||||
**一个接口同时支持创建和更新**:
|
||||
- `productId` **不传** = 创建新产品,返回新productId
|
||||
- `productId` **传了** = 更新已有产品,返回原productId
|
||||
|
||||
### 创建产品(productId不传)
|
||||
|
||||
```json
|
||||
// POST /admin/product/item/basic
|
||||
{
|
||||
"productType": "CORE", // 创建时必传: CORE/GROUP/CUSTOM
|
||||
"name": "额吉的故乡·亲子版", // 必传
|
||||
"tripDays": 6, // 可选
|
||||
"lineId": 100 // CORE/GROUP必传,CUSTOM可空
|
||||
}
|
||||
```
|
||||
|
||||
**响应**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "成功",
|
||||
"data": 2043246204711550977 // 新产品ID
|
||||
}
|
||||
```
|
||||
|
||||
### 更新产品(productId传已有ID)
|
||||
|
||||
```json
|
||||
// POST /admin/product/item/basic
|
||||
{
|
||||
"productId": 2043246204711550977, // 传了就是更新
|
||||
"version": 0, // 更新时必传(乐观锁)
|
||||
"name": "额吉的故乡·亲子版",
|
||||
"subtitle": "6天5晚草原环线",
|
||||
"tripDays": 6,
|
||||
"lineId": 100,
|
||||
"coverImageUrl": "https://...",
|
||||
"seasons": ["summer", "autumn"],
|
||||
"tags": ["亲子", "研学"],
|
||||
"tiers": [
|
||||
{"tierSeq": 1, "tierName": "舒适"},
|
||||
{"tierSeq": 2, "tierName": "豪华"}
|
||||
],
|
||||
"paymentType": "FULL",
|
||||
"showReview": true
|
||||
}
|
||||
```
|
||||
|
||||
**响应**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "成功",
|
||||
"data": 2043246204711550977 // 原产品ID
|
||||
}
|
||||
```
|
||||
|
||||
### 前端使用方式
|
||||
|
||||
```
|
||||
新建产品:
|
||||
1. 弹窗填 name + productType + lineId
|
||||
2. POST /admin/product/item/basic(不传productId)
|
||||
3. 拿到返回的 productId → 跳转编辑页
|
||||
|
||||
编辑产品:
|
||||
1. GET /admin/product/item/{id} 拿详情 + version
|
||||
2. 修改字段
|
||||
3. POST /admin/product/item/basic(传productId + version)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 字典补充:payment_type 已恢复
|
||||
|
||||
`GET /admin/dict/data/type/payment_type`
|
||||
|
||||
| 值 | 中文 |
|
||||
|----|------|
|
||||
| FULL | 全款支付 |
|
||||
| DEPOSIT | 订金+尾款 |
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户