代购系统 API 介绍

1. 用户相关 API
用户注册
POST /api/users/register
参数：username, email, password, phone
返回：user_id, token

用户登录
POST /api/users/login
参数：email, password
返回：token, user_info

获取用户信息
GET /api/users/me
请求头：Authorization: Bearer {token}
返回：user_details

修改用户信息
PUT /api/users/me
请求头：Authorization: Bearer {token}
参数：name, phone, address

2. 商品相关 API
获取商品列表
GET /api/products?category={id}&page={page}&limit={limit}
返回：products, total, page

获取商品详情
GET /api/products/{id}
返回：product_details

搜索商品
GET /api/products/search?q={keyword}

3. 代购单 API
创建代购单
POST /api/orders
请求头：Authorization: Bearer {token}
参数：product_id, quantity, shipping_address, notes
返回：order_id, status

获取代购单列表
GET /api/orders?status={status}
返回：orders

获取代购单详情
GET /api/orders/{id}

取消代购单
PUT /api/orders/{id}/cancel
条件：订单状态为待支付 / 待确认

4. 支付 API
创建支付
POST /api/payments
参数：order_id, payment_method
返回：payment_url / payment_id

支付回调
POST /api/payments/callback
由第三方支付平台调用

5. 管理员 API
商品管理（增删改查）
订单管理（修改状态、退款）
用户管理（禁用、查询）
6. 数据返回格式示例
json

{
 "code": 200,
 "message": "success",
 "data": {
   "id": 123,
   "name": "代购商品",
   "price": 199.00
 }

审核编辑 黄宇