用户管理 / 获取用户列表
GET /api/v1/users
获取所有用户列表,支持分页和筛选。
pageinteger页码,默认 1
limitinteger每页数量,默认 20,最大 100
keywordstring搜索关键词(用户名/邮箱)
// 响应示例 { "code": 200, "data": { "list": [ { "id": 1, "name": "张三", "email": "zhangsan@example.com" } ], "total": 50, "page": 1, "limit": 20 } }
用户管理 / 创建用户
POST /api/v1/users
创建新用户。
namestring用户姓名(必填)
emailstring邮箱地址(必填)
passwordstring密码(必填,至少 6 位)
// 响应示例 { "code": 201, "message": "用户创建成功", "data": { "id": 101, "name": "李四", "email": "lisi@example.com" } }
商品管理 / 获取商品列表
GET /api/v1/products
获取商品列表,支持按分类和价格筛选。
categorystring商品分类(可选)
min_pricenumber最低价格(可选)
max_pricenumber最高价格(可选)
// 响应示例 { "code": 200, "data": [ { "id": 1, "name": "智能手表", "price": 899, "category": "数码" } ] }
商品管理 / 更新商品
PUT /api/v1/products/{id}
更新商品信息。
idinteger商品 ID(路径参数)
namestring商品名称(可选)
pricenumber价格(可选)
// 响应示例 { "code": 200, "message": "更新成功", "data": { "id": 1, "name": "智能手表 Pro", "price": 1099 } }
订单管理 / 创建订单
POST /api/v1/orders
创建新订单。
user_idinteger用户 ID(必填)
product_idinteger商品 ID(必填)
quantityinteger购买数量(必填,≥1)
// 响应示例 { "code": 201, "message": "订单创建成功", "data": { "order_id": 1001, "status": "pending" } }
工具类 / 天气查询
GET /api/v1/tools/weather
实时天气查询。
citystring城市名称(必填)
// 响应示例 { "code": 200, "data": { "city": "深圳", "temperature": 28, "humidity": 75, "condition": "多云" } }
工具类 / IP归属地查询
GET /api/v1/tools/ip-location
IP 归属地查询。
ipstringIP 地址(必填)
// 响应示例 { "code": 200, "data": { "ip": "8.8.8.8", "country": "美国", "city": "山景城", "isp": "Google" } }