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
}

審核編輯 黃宇