diet-web-ui/doc/ingredient.md

# 食材部分

# 1. 查询食材

> GET /api/ingredient

### 输入:
```
pageSize=20  // 默认20, 全部非必填
pageNo=0     // 默认0, 从0开始
keyword=01   // 查询关键字，模糊匹配用
type=谷薯类   // 食材类型
mark=常用     // 食材标记. 业务端用标记，管理端没用
```

### 输出:
```
{
  "body": {
    "content": [
      {
        "key": "011101",
        "mark": "常用",
        "name": "小麦",
        "nutrient": {
          "fat": 10,
          "energy": 10,
          "calcium": 12,
          "protein": 15,
          "vitamin-a": 23
        },
        "time": 1693759354000,
        "type": "谷薯类"
      }
    ],
    "number": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  },
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 2. 添加食材(管理端接口)

> PUT /api/ingredient

### 输入:
```
Content-Type:application/x-www-form-urlencoded
key=010101   // 必填
name=测试食材  // 必填
type=粗粮    // 必填  全部必填   取值范围见(/api/basic/enum) category
nutrient={"fat": 10, "energy": 10, "calcium": 12, "protein": 15, "vitamin-a": 23}
// 必填 取值范围见(/api/basic/enum) nutrient
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 3. 修改食材(管理端接口)

> POST /api/ingredient

### 输入:
```
Content-Type:application/x-www-form-urlencoded
key=010101   // 必填
name=测试食材
type=粗粮
nutrient={"fat": 10, "energy": 10, "calcium": 12, "protein": 15, "vitamin-a": 23}

```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```
# 4. 删除食材(管理端接口)

> DELETE /api/ingredient

### 输入:
```
Content-Type:application/x-www-form-urlencoded
keys=010101,0101012,0101013  // 必填

```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 5. 食材打标(业务端接口)

> PUT /api/ingredient/mark

### 输入:
```
Content-Type:application/x-www-form-urlencoded
key=010101 // 食材编号
mark=常用          // 必填, 取值:  常用/忌用

```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 6. 取消打标(业务端接口)

> DELETE /api/ingredient/mark

### 输入:
```
Content-Type:application/x-www-form-urlencoded
key=010101    // 食材编号

```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 7. 批量导入(管理端接口, 暂不可用)

> PUT /api/ingredient/upload

### 输入:
```
Content-Type: multipart/form-data
files   // 必传

```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```