发表于: 2018-03-04 23:04:58
1 685
今天完成的事情:
今天和梁耀商量了一下,大概的把接口订了出来
前台接口:
请求地址::get /a/xinhuameiyu
请求参数:
字段 | 说明 | 类型 | 必填 | 备注 |
token | 加密传输信息 | string | 必填 | 通过des加密,其内容为 “username=&name=&mobile=”的des加密 |
注:以上参数经过des加密,密匙为a7ca3c5d
后台接口:
1.用户统计
请求地址:get /a/u/xinhuameiyu/user/list
请求参数:
字段 | 说明 | 类型 | 必填 | 备注 | ||
username | 用户名 | string | 否 |
|
| |
mobile | 手机号 | string | 否 |
| ||
minOrderNumber | 最小订单数 | number | 否 |
|
| |
maxOrderNumber | 最大订单数 | number | 否 |
|
| |
minOrderMoney | 最小订单总金额 | number | 否 |
|
| |
maxOrderMoney | 最大订单总金额 | number | 否 |
|
| |
page | 页数 | number | 否 |
|
| |
size | 每页数据数 | number | 否 |
|
| |
返回参数:
字段 | 说明 | 类型 |
code | 状态码 | number |
message | 消息 | string |
total | 查询数据总量 | number |
allUser | 新华美育用户总量 | number |
data | 数据 | array |
data
字段 | 说明 | 类型 | 备注 |
id | 用户id | number |
|
username | 用户名 | string |
|
name | 真实姓名 | string | |
mobile | 手机号码 | string |
|
subjectOrderNumber | 专题订单数 | number |
|
memberOrderNumber | 会员订单数 | number |
|
orderTotalMoney | 订单总额度 | number |
|
2.新华美育用户详情
请求地址:get /a/u/xinhuameiyu/user/{id}
返回参数:
字段 | 说明 | 类型 |
code | 状态码 | number |
message | 消息 | string |
data | 数据 | object |
data
字段 | 说明 | 类型 | 备注 |
username | 用户名 | string |
|
name | 用户真实姓名 | string |
|
mobile | 手机号 | string |
|
orderHistory | 订单记录 | array |
|
orderHistory
字段 | 说明 | 类型 | 备注 |
orderType | 订单类型 | string |
|
oderName | 订单名称 | string |
|
orderMoney | 订单金额 | number |
|
orderTime | 订单时间 | number |
|
3.订单统计
请求地址:get /a/u/xinhuameiyu/order/list
请求参数:
字段 | 说明 | 类型 | 必填 | 备注 | ||
startAt | 开始日期 | number | 否 |
|
| |
endAt | 结束日期 | number | 否 |
| ||
返回参数:
字段 | 说明 | 类型 |
code | 状态码 | number |
message | 消息 | string |
totalTrades | 交易总笔数 | number |
totalTradesMoney | 交易总金额 | number |
total | 数据总数 | number |
data | 数据 | array |
data
字段 | 说明 | 类型 | 备注 |
orderTime | 订单时间 | number | 时间戳 |
orderNumber | 订单总笔数 |
|
|
subjectOrderNumber | 专题订单数 |
|
|
memberOrderNumber | 会员订单数 |
|
|
subjectOrderMoney | 专题订单额度 |
|
|
memberOrderMoney | 会员订单金额 |
|
|
oderTotalMoney | 订单总金额 |
|
|
4.订单详情
请求地址:get /a/u/xinhuameiyu/order/{ordertime}
注:{ordertime}为订单时间,具体为当天的零点的时间戳(number类型)
返回参数:
字段 | 说明 | 类型 |
code | 状态码 | number |
message | 消息 | string |
data | 数据 | array |
data
字段 | 说明 | 类型 | 备注 |
username | 用户名 | string |
|
orderTime | 订单时间 | number | 时间戳 |
orderType | 订单类型 | string |
|
orderName | 订单名称 | string |
|
orderMoney | 订单金额 | number |
|
除了第一个之外,都是后台
本来想着编写假数据,虽然接口大概不会改动了,但是还是要等方案订下来吧
明天计划的事情:
和绍博师兄看一下方案有没有问题,拆解禅道,然后写假数据,开始写接口
遇到的问题:
无
收获:
完成接口文档
进度:
明天进行方案评审,时间待估
评论