通用
- 接口以
/api
开头 - 默认所有接口都有
Content-Type application/json
Accept application/json
- 服务端错误返回 5xx
{
"message":"消息"
}
注册接口
POST /api/register
Content-Type application/json
Accept application/json
{
"username":"zhangsan",
"password":"123456"
}
成功返回 201 Created
如果用户已经存在 409 Conflict
服务端错误返回 5xx
{
"message":"消息"
}
登陆接口
POST /api/login
Content-Type application/json
Accept application/json
{
"username":"zhangsan",
"password":"123456"
}
成功返回 302跳转到指定页面
用户名密码不对返回403 Forbidden
用户不存在返回404 Not Found
查询登陆状态
GET /api/loginStatus
成功返回200 OK
{
"login":true
"user":{
"id":"123",
"name":"zhangsan",
"avatarUrl":"https://image..."
}
}
如果没有登陆状态
{
"login":"false"
}
商品接口
id | title | description | price |
获取所有的商品
注意,price的单位是分
GET /goods
[
{
"id":"123",
"title":"记事本",
"description":"一个记事本",
"prise":"123"
"seller":{
"id":"123",
"name":"一个商家"
}
}
]
新增一个商品
POST /goods
[
{
"id":"123",
"title":"记事本",
"description":"一个记事本",
"prise":"123"
}
]
成功返回201
失败返回403
修改一个商品
PATCH /goods/123
[
{
"id":"123",
"title":"记事本",
"description":"一个记事本",
"prise":"123"
}
]
成功返回200
失败返回403
删除一个商品
DELETE /goods
[
{
"id":"123",
"title":"记事本",
"description":"一个记事本",
"prise":"123"
}
]
成功返回200
失败返回403