# 食材部分 # 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 ingredients=010101,0101012,0101013 // 必填 ``` ### 输出: ``` { "code": 200, "desc": "成功", "success": true } ``` # 5. 食材打标(业务端接口) > PUT /api/ingredient/mark ### 输入: ``` Content-Type:application/x-www-form-urlencoded ingredient=010101 // 食材编号 mark=常用 // 必填, 取值: 常用/忌用 ``` ### 输出: ``` { "code": 200, "desc": "成功", "success": true } ``` # 6. 取消打标(业务端接口) > DELETE /api/ingredient/mark ### 输入: ``` Content-Type:application/x-www-form-urlencoded ingredient=010101 // 食材编号 ``` ### 输出: ``` { "code": 200, "desc": "成功", "success": true } ``` # 7. 批量导入(管理端接口, 暂不可用) > PUT /api/ingredient/upload ### 输入: ``` Content-Type: multipart/form-data files // 必传 ``` ### 输出: ``` { "code": 200, "desc": "成功", "success": true } ```