以下是「晨光宅配」小程序的完整接口文档,涵盖了所有12个表的接口。
每个接口包括请求方法、URL、请求参数、响应格式和示例
接口文档
1. 用户模块
1.1 获取用户信息
- URL:
/user/{userId}
- 方法:
GET
- 请求参数:
userId
(路径参数): 用户ID
- 响应格式:
{"userId": 1,"openid": "openid_123456","phone": "13800138000","nickname": "小明","avatarUrl": "https://example.com/avatar1.jpg","createTime": "2023-10-01T12:00:00" }
1.2 获取所有用户
- URL:
/user
- 方法:
GET
- 响应格式:
[{"userId": 1,"openid": "openid_123456","phone": "13800138000","nickname": "小明","avatarUrl": "https://example.com/avatar1.jpg","createTime": "2023-10-01T12:00:00"} ]
1.3 创建用户
- URL:
/user
- 方法:
POST
- 请求体:
{"openid": "openid_123456","phone": "13800138000","nickname": "小明","avatarUrl": "https://example.com/avatar1.jpg" }
- 响应格式:
true
1.4 更新用户
- URL:
/user
- 方法:
PUT
- 请求体:
{"userId": 1,"openid": "openid_123456","phone": "13800138000","nickname": "小明","avatarUrl": "https://example.com/avatar1.jpg" }
- 响应格式:
true
1.5 删除用户
- URL:
/user/{userId}
- 方法:
DELETE
- 请求参数:
userId
(路径参数): 用户ID
- 响应格式:
true
1.6 搜索用户
- URL:
/user/search?keyword=小明
- 方法:
GET
- 请求参数:
keyword
(查询参数): 搜索关键字
- 响应格式:
[{"userId": 1,"openid": "openid_123456","phone": "13800138000","nickname": "小明","avatarUrl": "https://example.com/avatar1.jpg","createTime": "2023-10-01T12:00:00"} ]
2. 地址模块
2.1 获取用户地址列表
- URL:
/address/user/{userId}
- 方法:
GET
- 请求参数:
userId
(路径参数): 用户ID
- 响应格式:
[{"addressId": 1,"userId": 1,"contactName": "小明","contactPhone": "13800138000","detailAddress": "北京市朝阳区XX路XX号","isDefault": 1} ]
2.2 添加地址
- URL:
/address
- 方法:
POST
- 请求体:
{"userId": 1,"contactName": "小明","contactPhone": "13800138000","detailAddress": "北京市朝阳区XX路XX号","isDefault": 1 }
- 响应格式:
true
2.3 更新地址
- URL:
/address
- 方法:
PUT
- 请求体:
{"addressId": 1,"userId": 1,"contactName": "小明","contactPhone": "13800138000","detailAddress": "北京市朝阳区XX路XX号","isDefault"