- 接口基准地址:
http://localhost:8888/api/private/v1/
- 服务端已开启 CORS 跨域支持
- API V1 认证统一使用 Token 认证
- 需要授权的 API ,必须在请求头中使用
Authorization
字段提供 token
令牌
- 使用 HTTP Status Code 标识状态
- 数据返回格式统一使用 JSON
- GET(SELECT):从服务器取出资源(一项或多项)。
- POST(CREATE):在服务器新建一个资源。
- PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
- PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
- DELETE(DELETE):从服务器删除资源。
- HEAD:获取资源的元数据。
- OPTIONS:获取信息,关于资源的哪些属性是客户端可以改变的。
状态码 |
含义 |
说明 |
200 |
OK |
请求成功 |
201 |
CREATED |
创建成功 |
204 |
DELETED |
删除成功 |
400 |
BAD REQUEST |
请求的地址不存在或者包含不支持的参数 |
401 |
UNAUTHORIZED |
未授权 |
403 |
FORBIDDEN |
被禁止访问 |
404 |
NOT FOUND |
请求的资源不存在 |
422 |
Unprocesable entity |
[POST/PUT/PATCH] 当创建一个对象时,发生一个验证错误 |
500 |
INTERNAL SERVER ERROR |
内部错误 |
|
|
|
- 请求路径:login
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
username |
用户名 |
不能为空 |
password |
密码 |
不能为空 |
参数名 |
参数说明 |
备注 |
id |
用户 ID |
|
rid |
用户角色 ID |
|
username |
用户名 |
|
mobile |
手机号 |
|
email |
邮箱 |
|
token |
令牌 |
基于 jwt 的令牌 |
{
"data": {
"id": 500,
"rid": 0,
"username": "admin",
"mobile": "123",
"email": "[email protected]",
"token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjUwMCwicmlkIjowLCJpYXQiOjE1MTI1NDQyOTksImV4cCI6MTUxMjYzMDY5OX0.eGrsrvwHm-tPsO9r_pxHIQ5i5L1kX9RX444uwnRGaIM"
},
"meta": {
"msg": "登录成功",
"status": 200
}
}
参数名 |
参数说明 |
备注 |
query |
查询参数 |
可以为空 |
pagenum |
当前页码 |
不能为空 |
pagesize |
每页显示条数 |
不能为空 |
参数名 |
参数说明 |
备注 |
totalpage |
总记录数 |
|
pagenum |
当前页码 |
|
users |
用户数据集合 |
|
{
"data": {
"totalpage": 5,
"pagenum": 4,
"users": [
{
"id": 25,
"username": "tige117",
"mobile": "18616358651",
"type": 1,
"openid": "",
"email": "[email protected]",
"create_time": "2017-11-09T20:36:26.000Z",
"modify_time": null,
"is_delete": false,
"is_active": false
}
]
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:users
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
username |
用户名称 |
不能为空 |
password |
用户密码 |
不能为空 |
email |
邮箱 |
可以为空 |
mobile |
手机号 |
可以为空 |
参数名 |
参数说明 |
备注 |
id |
用户 ID |
|
rid |
用户角色 ID |
|
username |
用户名 |
|
mobile |
手机号 |
|
email |
邮箱 |
|
{
"data": {
"id": 28,
"username": "tige1200",
"mobile": "test",
"type": 1,
"openid": "",
"email": "[email protected]",
"create_time": "2017-11-10T03:47:13.533Z",
"modify_time": null,
"is_delete": false,
"is_active": false
},
"meta": {
"msg": "用户创建成功",
"status": 201
}
}
- 请求路径:users/:uId/state/:type
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
uId |
用户 ID |
不能为空携带在url中 |
type |
用户状态 |
不能为空携带在url中 ,值为 true 或者 false |
{
"data": {
"id": 566,
"rid": 30,
"username": "admin",
"mobile": "123456",
"email": "[email protected]",
"mg_state": 0
},
"meta": {
"msg": "设置状态成功",
"status": 200
}
}
- 请求路径:users/:id
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
id |
用户 ID |
不能为空携带在url中 |
参数名 |
参数说明 |
备注 |
id |
用户 ID |
|
role_id |
角色 ID |
|
mobile |
手机号 |
|
email |
邮箱 |
|
{
"data": {
"id": 503,
"username": "admin3",
"role_id": 0,
"mobile": "00000",
"email": "[email protected]"
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
- 请求路径:users/:id
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
用户 id |
不能为空 参数是url参数:id |
email |
邮箱 |
可以为空 |
mobile |
手机号 |
可以为空 |
参数名 |
参数说明 |
备注 |
id |
用户 ID |
|
role_id |
角色 ID |
|
mobile |
手机号 |
|
email |
邮箱 |
|
/* 200表示成功,500表示失败 */
{
"data": {
"id": 503,
"username": "admin3",
"role_id": 0,
"mobile": "111",
"email": "[email protected]"
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
- 请求路径:users/:id
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
id |
用户 id |
不能为空参数是url参数:id |
{
"data": null,
"meta": {
"msg": "删除成功",
"status": 200
}
}
- 请求路径:users/:id/role
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
用户 ID |
不能为空参数是url参数:id |
rid |
角色 id |
不能为空参数body参数 |
参数名 |
参数说明 |
备注 |
id |
用户 ID |
|
role_id |
角色 ID |
|
mobile |
手机号 |
|
email |
邮箱 |
|
{
"data": {
"id": 508,
"rid": "30",
"username": "asdf1",
"mobile": "123123",
"email": "[email protected]"
},
"meta": {
"msg": "设置角色成功",
"status": 200
}
}
- 请求路径:rights/:type
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
type |
类型 |
值: list 或 tree , list 列表显示权限, tree 树状显示权限,参数是url参数:type |
参数名 |
参数说明 |
备注 |
id |
权限 ID |
|
authName |
权限说明 |
|
level |
权限层级 |
|
pid |
权限父 ID |
|
path |
对应访问路径 |
|
{
"data": [
{
"id": 101,
"authName": "商品管理",
"level": "0",
"pid": 0,
"path": null
},
{
"id": 102,
"authName": "订单管理",
"level": "0",
"pid": 0,
"path": null
}
],
"meta": {
"msg": "获取权限列表成功",
"status": 200
}
}
type=tree
;[
{
data: [
{
id: 101,
authName: '商品管理',
path: null,
pid: 0,
children: [
{
id: 104,
authName: '商品列表',
path: null,
pid: 101,
children: [
{
id: 105,
authName: '添加商品',
path: null,
pid: '104,101'
}
]
}
]
}
],
meta: {
msg: '获取权限列表成功',
status: 200
}
}
]
{
"data":
{
"id": 101,
"authName": "商品管理",
"path": null,
"children": [
{
"id": 104,
"authName": "商品列表",
"path": null,
"children": []
}
]
}
"meta": {
"msg": "获取菜单列表成功",
"status": 200
}
}
- 请求路径:roles
- 请求方法:get
- 响应数据说明
- 第一层为角色信息
- 第二层开始为权限说明,权限一共有 3 层权限
- 响应数据
{
"data": [
{
"id": 30,
"roleName": "主管",
"roleDesc": "技术负责人",
"children": [
{
"id": 101,
"authName": "商品管理",
"path": null,
"children": [
{
"id": 104,
"authName": "商品列表",
"path": null,
"children": [
{
"id": 105,
"authName": "添加商品",
"path": null
}
]
}
]
}
]
}
],
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:roles
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
roleName |
角色名称 |
不能为空 |
roleDesc |
角色描述 |
可以为空 |
参数名 |
参数说明 |
备注 |
roleId |
角色 ID |
|
roleName |
角色名称 |
|
roleDesc |
角色描述 |
|
{
"data": {
"roleId": 40,
"roleName": "admin2",
"roleDesc": "admin2Desc"
},
"meta": {
"msg": "创建成功",
"status": 201
}
}
- 请求路径:roles/:id
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
角色 ID |
不能为空携带在url中 |
参数名 |
参数说明 |
备注 |
roleId |
角色 ID |
|
roleName |
角色名称 |
|
roleDesc |
角色描述 |
|
{
"data": {
"roleId": 31,
"roleName": "测试角色",
"roleDesc": "测试负责人"
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:roles/:id
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
角色 ID |
不能为空携带在url中 |
roleName |
角色名称 |
不能为空 |
roleDesc |
角色描述 |
可以为空 |
{
"data": {
"roleId": 31,
"roleName": "测试角色",
"roleDesc": "测试角色描述"
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:roles/:id
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
角色 ID |
不能为空携带在url中 |
{
"data": null,
"meta": {
"msg": "删除成功",
"status": 200
}
}
- 请求路径:roles/:roleId/rights
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
:roleId |
角色 ID |
不能为空携带在url中 |
rids |
权限 ID 列表 |
以 , 分割的权限 ID 列表 |
{
"data": null,
"meta": {
"msg": "更新成功",
"status": 200
}
}
- 请求路径:roles/:roleId/rights/:rightId
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
:roleId |
角色 ID |
不能为空携带在url中 |
:rightId |
权限 ID |
不能为空携带在url中 |
{
"data": [
{
"id": 101,
"authName": "商品管理",
"path": null,
"children": [
{
"id": 104,
"authName": "商品列表",
"path": null,
"children": [
{
"id": 105,
"authName": "添加商品",
"path": null
},
{
"id": 116,
"authName": "修改",
"path": null
}
]
}
]
}
],
"meta": {
"msg": "取消权限成功",
"status": 200
}
}
- 请求路径:categories
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
type |
[1,2,3] |
值:1,2,3 分别表示显示一层二层三层分类列表 |
参数名 |
参数说明 |
备注 |
cat_id |
分类 ID |
|
cat_name |
分类名称 |
|
cat_pid |
分类父 ID |
|
cat_level |
分类当前层级 |
|
{
"data": [
{
"cat_id": 1,
"cat_name": "手机相机",
"cat_pid": 0,
"cat_level": 0
},
{
"cat_id": 2,
"cat_name": "电脑办公",
"cat_pid": 0,
"cat_level": 0
}
],
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:categories
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
cat_pid |
分类父 ID |
不能为空 |
cat_name |
分类名称 |
不能为空 |
cat_level |
分类层级 |
不能为空 |
{
"data": {
"cat_id": 62,
"cat_name": "相框",
"cat_pid": "1",
"cat_level": "1"
},
"meta": {
"msg": "创建成功",
"status": 201
}
}
- 请求路径:categories/:id
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
{
"data": {
"cat_id": 3,
"cat_name": "厨卫电器",
"cat_pid": 0,
"cat_level": 0
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:categories/:id
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
cat_name |
分类名称 |
不能为空 |
{
"data": {
"cat_id": 22,
"cat_name": "自拍杆",
"cat_pid": 7,
"cat_level": 2
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
- 请求路径:categories/:id
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
{
"data": null,
"meta": {
"msg": "删除成功",
"status": 200
}
}
- 请求路径:categories/:id/attributes
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
sel |
[only,many] |
不能为空,通过 only 或 many 来获取分类静态参数还是动态参数 |
参数名 |
参数说明 |
备注 |
attr_id |
分类参数 ID |
|
attr_name |
分类参数名称 |
|
cat_id |
分类参数所属分类 |
|
attr_sel |
only:输入框(唯一) many:后台下拉列表/前台单选框 |
|
attr_write |
manual:手工录入 list:从列表选择 |
|
attr_vals |
如果 attr_write:list,那么有值,该值以逗号分隔 |
|
{
"data": [
{
"attr_id": 1,
"attr_name": "cpu",
"cat_id": 22,
"attr_sel": "only",
"attr_write": "manual",
"attr_vals": "ffff"
}
],
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:categories/:id/attributes
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
attr_name |
参数名称 |
不能为空 |
attr_sel |
[only,many] |
不能为空 |
attr_vals |
如果是 many 就需要填写值的选项,以逗号分隔 |
|
{
"data": {
"attr_id": 44,
"attr_name": "测试参数",
"cat_id": "1",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": "a,b,c"
},
"meta": {
"msg": "创建成功",
"status": 201
}
}
- 请求路径:categories/:id/attributes/:attrid
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
:attrid |
参数 ID |
不能为空携带在url中 |
{
"data": null,
"meta": {
"msg": "删除成功",
"status": 200
}
}
- 请求路径:categories/:id/attributes/:attrId
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
:attrId |
属性 ID |
不能为空携带在url中 |
attr_sel |
[only,many] |
不能为空 |
attr_vals |
如果是 many 就需要填写值的选项,以逗号分隔 |
|
{
"data": {
"attr_id": 1,
"attr_name": "cpu",
"cat_id": 22,
"attr_sel": "only",
"attr_write": "manual",
"attr_vals": "ffff"
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:categories/:id/attributes/:attrId
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
:id |
分类 ID |
不能为空携带在url中 |
:attrId |
属性 ID |
不能为空携带在url中 |
{
"data": {
"attr_id": 9,
"attr_name": "测试更新",
"cat_id": "43",
"attr_sel": "only",
"attr_write": "manual",
"attr_vals": "abc"
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
参数名 |
参数说明 |
备注 |
query |
查询参数 |
可以为空 |
pagenum |
当前页码 |
不能为空 |
pagesize |
每页显示条数 |
不能为空 |
参数名 |
参数说明 |
备注 |
total |
总共商品条数 |
|
pagenum |
当前商品页数 |
|
goods_id |
商品 ID |
|
goods_name |
商品名称 |
|
goods_price |
价格 |
|
goods_number |
数量 |
|
goods_weight |
重量 |
不能为空 |
goods_state |
商品状态 |
商品状态 0: 未通过 1: 审核中 2: 已审核 |
add_time |
添加时间 |
|
upd_time |
更新时间 |
|
hot_mumber |
热销品数量 |
|
is_promote |
是否是热销品 |
|
{
"data": {
"total": 50,
"pagenum": "1",
"goods": [
{
"goods_id": 144,
"goods_name": "asfdsd",
"goods_price": 1,
"goods_number": 1,
"goods_weight": 1,
"goods_state": null,
"add_time": 1512954923,
"upd_time": 1512954923,
"hot_mumber": 0,
"is_promote": false
}
]
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:goods
- 请求方法:post
- 请求参数
参数名 |
参数说明 |
备注 |
goods_name |
商品名称 |
不能为空 |
goods_cat |
以为','分割的分类列表 |
不能为空 |
goods_price |
价格 |
不能为空 |
goods_number |
数量 |
不能为空 |
goods_weight |
重量 |
不能为空 |
goods_introduce |
介绍 |
可以为空 |
pics |
上传的图片临时路径(对象) |
可以为空 |
attrs |
商品的参数(数组) |
可以为空 |
{
"goods_name":"test_goods_name2",
"goods_price":20,
"goods_number":30,
"goods_weight":40,
"goods_introduce":"abc",
"pics":[
{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}
],
"attrs":[
{
"attr_id":15,
"attr_value":"ddd"
},
{
"attr_id":15,
"attr_value":"eee"
}
]
}
参数名 |
参数说明 |
备注 |
total |
总共商品条数 |
|
pagenum |
当前商品页数 |
|
goods_id |
商品 ID |
|
goods_cat |
以为','分割的分类列表 |
|
goods_name |
商品名称 |
|
goods_price |
价格 |
|
goods_number |
数量 |
|
goods_weight |
重量 |
不能为空 |
goods_state |
商品状态 |
商品状态 0: 未通过 1: 审核中 2: 已审核 |
add_time |
添加时间 |
|
upd_time |
更新时间 |
|
hot_mumber |
热销品数量 |
|
is_promote |
是否是热销品 |
|
pics |
上传的图片临时路径(对象) |
pics_id:图片 ID,goods_id:商品 ID,pics_big:大图,pics_mid:中图,pics_sma:小图 |
attrs |
商品的参数(数组) |
goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:手动输入,还是单选, |
{
"data": {
"goods_id": 145,
"goods_name": "test_goods_name2",
"goods_price": 20,
"cat_id": 1,
"goods_number": 30,
"goods_weight": 40,
"goods_introduce": "abc",
"goods_big_logo": "",
"goods_small_logo": "",
"goods_state": 1,
"add_time": 1512962370,
"upd_time": 1512962370,
"hot_mumber": 0,
"is_promote": false,
"pics": [
{
"pics_id": 397,
"goods_id": 145,
"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8",
"pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8",
"pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"
}
],
"attrs": [
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "ddd",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
},
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "eee",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
}
]
},
"meta": {
"msg": "创建商品成功",
"status": 201
}
}
- 请求路径:goods/:id
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
id |
商品 ID |
不能为空携带在url中 |
参数名 |
参数说明 |
备注 |
total |
总共商品条数 |
|
pagenum |
当前商品页数 |
|
goods_id |
商品 ID |
|
goods_name |
商品名称 |
|
goods_price |
价格 |
|
goods_number |
数量 |
|
goods_weight |
重量 |
不能为空 |
goods_state |
商品状态 |
商品状态 0: 未通过 1: 审核中 2: 已审核 |
add_time |
添加时间 |
|
upd_time |
更新时间 |
|
hot_mumber |
热销品数量 |
|
is_promote |
是否是热销品 |
|
pics |
上传的图片临时路径(对象) |
pics_id:图片 ID,goods_id:商品 ID,pics_big:大图,pics_mid:中图,pics_sma:小图 |
attrs |
商品的参数(数组) |
goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:手动输入,还是单选, |
{
"data": {
"goods_id": 145,
"goods_name": "test_goods_name2",
"goods_price": 20,
"goods_number": 30,
"goods_weight": 40,
"goods_introduce": "abc",
"goods_big_logo": "",
"goods_small_logo": "",
"goods_state": 1,
"add_time": 1512962370,
"upd_time": 1512962370,
"hot_mumber": 0,
"is_promote": false,
"pics": [
{
"pics_id": 397,
"goods_id": 145,
"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8",
"pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8",
"pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"
}
],
"attrs": [
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "ddd",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
},
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "eee",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
}
]
},
"meta": {
"msg": "创建商品成功",
"status": 201
}
}
- 请求路径:goods/:id
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
商品 ID |
不能为空携带在url中 |
goods_name |
商品名称 |
不能为空 |
goods_price |
价格 |
不能为空 |
goods_number |
数量 |
不能为空 |
goods_weight |
重量 |
不能为空 |
goods_introduce |
介绍 |
可以为空 |
pics |
上传的图片临时路径(对象) |
可以为空 |
attrs |
商品的参数(数组) |
可以为空 |
{
"goods_name":"test_goods_name2",
"goods_price":20,
"goods_number":30,
"goods_weight":40,
"goods_introduce":"abc",
"pics":[
{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}
],
"attrs":[
{
"attr_id":15,
"attr_value":"ddd"
},
{
"attr_id":15,
"attr_value":"eee"
}
]
}
参数名 |
参数说明 |
备注 |
total |
总共商品条数 |
|
pagenum |
当前商品页数 |
|
goods_id |
商品 ID |
|
goods_name |
商品名称 |
|
goods_price |
价格 |
|
goods_number |
数量 |
|
goods_weight |
重量 |
不能为空 |
goods_state |
商品状态 |
商品状态 0: 未通过 1: 审核中 2: 已审核 |
add_time |
添加时间 |
|
upd_time |
更新时间 |
|
hot_mumber |
热销品数量 |
|
is_promote |
是否是热销品 |
|
pics |
上传的图片临时路径(对象) |
pics_id:图片 ID,goods_id:商品 ID,pics_big:大图,pics_mid:中图,pics_sma:小图 |
attrs |
商品的参数(数组) |
goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:手动输入,还是单选, |
{
"data": {
"goods_id": 145,
"goods_name": "test_goods_name2",
"goods_price": 20,
"goods_number": 30,
"goods_weight": 40,
"goods_introduce": "abc",
"goods_big_logo": "",
"goods_small_logo": "",
"goods_state": 1,
"add_time": 1512962370,
"upd_time": 1512962370,
"hot_mumber": 0,
"is_promote": false,
"pics": [
{
"pics_id": 397,
"goods_id": 145,
"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8",
"pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8",
"pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"
}
],
"attrs": [
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "ddd",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
},
{
"goods_id": 145,
"attr_id": 15,
"attr_value": "eee",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
}
]
},
"meta": {
"msg": "创建商品成功",
"status": 201
}
}
- 请求路径:goods/:id
- 请求方法:delete
- 请求参数
参数名 |
参数说明 |
备注 |
id |
商品 ID |
不能为空携带在url中 |
{
"data": null,
"meta": {
"msg": "删除成功",
"status": 200
}
}
###同步商品图片
- 请求路径:goods/:id/pics
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
商品 ID |
不能为空携带在url中 |
pics |
商品图片集合 |
如果有 pics_id 字段会保留该图片,如果没有 pics_id 但是有 pic 字段就会新生成图片数据 |
;[
{ pic: 'tmp_uploads/db28f6316835836e97653b5c75e418be.png' },
{
pics_id: 397,
goods_id: 145,
pics_big: 'uploads/goodspics/big_30f08d52c551ecb447277eae232304b8',
pics_mid: 'uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8',
pics_sma: 'uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8'
}
]
{
"data": {
"goods_id": 96,
"goods_name": "iphoneXX",
"goods_price": 2,
"goods_number": 22,
"goods_weight": 22,
"goods_introduce": null,
"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg",
"goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg",
"goods_state": 0,
"is_del": "1",
"add_time": 1510045904,
"upd_time": 1512635159,
"delete_time": 1512635159,
"hot_mumber": 0,
"is_promote": false,
"pics": [
{
"pics_id": 383,
"goods_id": 96,
"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg",
"pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg",
"pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"
}
],
"attrs": [
{
"goods_id": 96,
"attr_id": 15,
"attr_value": "eee",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
},
{
"goods_id": 96,
"attr_id": 15,
"attr_value": "ddd",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
}
]
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
###同步商品属性
- 请求路径:goods/:id/attributes
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
商品 ID |
不能为空携带在url中 |
;[
{
attr_id: 15,
attr_value: 'ddd'
},
{
attr_id: 15,
attr_value: 'eee'
}
]
{
"data": {
"goods_id": 96,
"goods_name": "iphoneXX",
"goods_price": 2,
"goods_number": 22,
"goods_weight": 22,
"goods_introduce": null,
"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg",
"goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg",
"goods_state": 0,
"is_del": "1",
"add_time": 1510045904,
"upd_time": 1512635159,
"delete_time": 1512635159,
"hot_mumber": 0,
"is_promote": false,
"pics": [
{
"pics_id": 383,
"goods_id": 96,
"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg",
"pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg",
"pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"
}
],
"attrs": [
{
"goods_id": 96,
"attr_id": 15,
"attr_value": "eee",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
},
{
"goods_id": 96,
"attr_id": 15,
"attr_value": "ddd",
"add_price": null,
"attr_name": "fffffff",
"attr_sel": "many",
"attr_write": "list",
"attr_vals": ""
}
]
},
"meta": {
"msg": "更新成功",
"status": 200
}
}
###商品图片处理必须安装 GraphicsMagick
apt-get install GraphicsMagick
brew install GraphicsMagick
- 请求路径:upload
- 请求方法:post
- 请求参数
{
"data": {
"tmp_path": "tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png",
"url": "http://127.0.0.1:8888tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png"
},
"meta": {
"msg": "上传成功",
"status": 200
}
}
- 请求路径:orders
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
query |
查询参数 |
可以为空 |
pagenum |
当前页码 |
不能为空 |
pagesize |
每页显示条数 |
不能为空 |
user_id |
用户 ID |
可以为空 |
pay_status |
支付状态 |
可以为空 |
is_send |
是否发货 |
可以为空 |
order_fapiao_title |
['个人','公司'] |
可以为空 |
order_fapiao_company |
公司名称 |
可以为空 |
order_fapiao_content |
发票内容 |
可以为空 |
consignee_addr |
发货地址 |
可以为空 |
{
"data": {
"total": 1,
"pagenum": "1",
"goods": [
{
"order_id": 47,
"user_id": 133,
"order_number": "itcast-59e7502d7993d",
"order_price": 322,
"order_pay": "1",
"is_send": "是",
"trade_no": "",
"order_fapiao_title": "个人",
"order_fapiao_company": "",
"order_fapiao_content": "办公用品",
"consignee_addr": "a:7:{s:6:\"cgn_id\";i:1;s:7:\"user_id\";i:133;s:8:\"cgn_name\";s:9:\"王二柱\";s:11:\"cgn_address\";s:51:\"北京市海淀区苏州街长远天地大厦305室\";s:7:\"cgn_tel\";s:11:\"13566771298\";s:8:\"cgn_code\";s:6:\"306810\";s:11:\"delete_time\";N;}",
"pay_status": "1",
"create_time": 1508331565,
"update_time": 1508331565
}
]
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:orders/:id
- 请求方法:put
- 请求参数
参数名 |
参数说明 |
备注 |
id |
订单 ID |
不能为空携带在url中 |
is_send |
订单是否发货 |
1:已经发货,0:未发货 |
order_pay |
订单支付 |
支付方式 0 未支付 1 支付宝 2 微信 3 银行卡 |
order_price |
订单价格 |
|
order_number |
订单数量 |
|
pay_status |
支付状态 |
订单状态: 0 未付款、1 已付款 |
-
请求数据说明
- 所有请求数据都是增量更新,如果参数不填写,就不会更新该字段
-
响应数据
{
"data": {
"order_id": 67,
"user_id": 1,
"order_number": "itcast-g7kmck71vjaujfgoi",
"order_price": 20,
"order_pay": "0",
"is_send": "否",
"trade_no": "",
"order_fapiao_title": "个人",
"order_fapiao_company": "",
"order_fapiao_content": "",
"consignee_addr": "",
"pay_status": "0",
"create_time": 1512533560,
"update_time": 1512533560,
"goods": [
{
"id": 82,
"order_id": 67,
"goods_id": 96,
"goods_price": 333,
"goods_number": 2,
"goods_total_price": 999
},
{
"id": 83,
"order_id": 67,
"goods_id": 95,
"goods_price": 666,
"goods_number": 5,
"goods_total_price": 999
}
]
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:orders/:id
- 请求方法:get
- 请求参数
参数名 |
参数说明 |
备注 |
id |
订单 ID |
不能为空携带在url中 |
{
"data": {
"order_id": 67,
"user_id": 1,
"order_number": "itcast-g7kmck71vjaujfgoi",
"order_price": 20,
"order_pay": "0",
"is_send": "否",
"trade_no": "",
"order_fapiao_title": "个人",
"order_fapiao_company": "",
"order_fapiao_content": "",
"consignee_addr": "",
"pay_status": "0",
"create_time": 1512533560,
"update_time": 1512533560,
"goods": [
{
"id": 82,
"order_id": 67,
"goods_id": 96,
"goods_price": 333,
"goods_number": 2,
"goods_total_price": 999
},
{
"id": 83,
"order_id": 67,
"goods_id": 95,
"goods_price": 666,
"goods_number": 5,
"goods_total_price": 999
}
]
},
"meta": {
"msg": "获取成功",
"status": 200
}
}
- 请求路径:reports/:type
- 请求方法:get
- 响应数据
- 请求路径:reports/:type
- 请求方法:get
- 响应数据
- 请求路径:reports/:type
- 请求方法:get
- 响应数据