AI酒仕 API 接口文档

👤 用户模块

POST /api/login/code 微信登录，用 code 换取 token

请求参数

参数	类型	必填	说明
code	string	是	wx.login() 获取的 code

响应示例

{ "token": "eyJhbGciOiJIUzI1NiIs...", "user": { "uid": 1, "name": "微信用户", "avatar": "https://..." } }

GET /api/user/info 需登录获取当前用户信息

Headers

Authorization: Bearer {token}

响应示例

{ "uid": 1, "name": "张三", "contact": "13800138000", "score": 100, "member_rank": 1, "avatar": "avatars/1_xxx.jpg" }

POST /api/user/update 需登录更新用户信息

请求参数

参数	类型	必填	说明
name	string	否	用户昵称
contact	string	否	手机号

POST /api/user/avatar/upload 需登录上传用户头像

请求方式

Content-Type: multipart/form-data

请求参数

参数	类型	必填	说明
file	file	是	图片文件 (jpg/png)

🍺 商品模块

GET /api/product/list?type={type} 获取商品列表

查询参数

参数	类型	必填	说明
type	string	是	brew(精酿)/other(其他)

GET /api/product/{id} 获取商品详情

路径参数

参数	类型	说明
id	int	商品ID

📦 订单模块

POST /api/order/beer/single 需登录创建单次酒类订单

请求参数

{ "products": [{ "product": 1, "count": 2, "specs": { "specs": "standard", "text": "标准规格", "price": 2500 } }], "destination": 1, "note": "备注信息" }

GET /api/order/list/all 需登录获取订单列表

查询参数

参数	类型	说明
status	string	筛选状态：pending/paid/preparing/delivered/completed/cancelled
page	int	页码，默认1
page_size	int	每页数量，默认10

GET /api/order/{type}/{id} 需登录获取订单详情

路径参数

参数	类型	说明
type	string	single/cycle/other
id	int	订单ID

POST /api/order/{type}/{id}/cancel 需登录取消订单

只能取消未发货的订单，已支付订单会进入退款流程

GET /api/order/pickup 获取自取点列表

获取所有可用的自取点地址

🤖 AI推荐模块

POST /api/v1/recommend 获取个性化推荐

请求参数

{ "taste_preference": { "bitterness": 0.8, "sweetness": 0.3 }, "scene_tags": ["party"], "budget_min": 20, "budget_max": 100, "text_description": "想要苦一点的" }

POST /api/v1/chat 与AI酒仕对话

请求参数

参数	类型	必填	说明
user_id	int	是	用户ID
message	string	是	用户消息
use_llm	bool	否	是否使用大模型，默认true

📤 上传模块

POST /api/upload/image 需登录通用图片上传

支持 jpg/png/gif/webp，最大5MB

请求方式

Content-Type: multipart/form-data

查询参数

参数	说明
folder	存储文件夹：common/comment/avatar/product

表单参数

参数	类型	说明
file	file	图片文件

POST /api/upload/comment-image 需登录评论图片上传

专用于评论中的图片上传

POST /api/upload/multiple 需登录批量图片上传（最多9张）

一次上传多张图片，适用于评论晒图等场景

💰 支付模块

POST /api/payment/create 需登录创建微信支付

请求参数

参数	类型	说明
order_id	int	订单ID
order_type	string	single/cycle/other

响应参数（用于调起微信支付）

{ "prepay_id": "wx...", "pay_params": { "appId": "wx...", "timeStamp": "1234567890", "nonceStr": "...", "package": "prepay_id=...", "signType": "RSA", "paySign": "..." } }

前端使用 pay_params 调起 wx.requestPayment()

GET /api/payment/status/{type}/{id} 需登录查询支付状态

查询订单是否已支付

POST /api/payment/refund 需登录申请退款

请求参数

参数	类型	必填	说明
order_id	int	是	订单ID
order_type	string	是	订单类型
refund_amount	int	否	退款金额（分），不传则全额退款
reason	string	否	退款原因

🎉 活动模块

GET /api/activity 获取活动列表

查询参数

参数	类型	说明
upcoming	bool	是否只显示未来活动，默认true
limit	int	返回数量，默认50

GET /api/activity/{id} 获取活动详情

POST /api/activity/{id} 需登录报名参加活动

GET /api/activity/my/registered 需登录获取我已报名的活动

💬 评论评分模块

GET /api/comment/product/{product_id} 获取商品评论列表

POST /api/comment/create 需登录发表评论

请求参数

参数	类型	说明
product_id	int	商品ID
content	string	评论内容
pics	array	图片URL数组

POST /api/score 需登录给商品评分

请求参数

参数	类型	说明
product_id	int	商品ID
score	int	评分 1-5

🍺 校园精酿AI酒仕 API 文档

👤 用户模块

请求参数

响应示例

Headers

响应示例

请求参数

请求方式

请求参数

🍺 商品模块

查询参数

路径参数

📦 订单模块

请求参数

查询参数

路径参数

🤖 AI推荐模块

请求参数

请求参数

📤 上传模块

请求方式

查询参数

表单参数

💰 支付模块

请求参数

响应参数（用于调起微信支付）

请求参数

🎉 活动模块

查询参数

💬 评论评分模块

请求参数

请求参数