1.账单接口
和账单相关操作
1.1 每月账单详情
返回每月账单详情，按天归类
必选参数: /{uid}/{Year}/{Month}
- uid: 用户id
- Year : 年份
- Month ： 月份
- 接口地址:
bill/user
调用例子:
http://bill.jiuyexd.cn/bill/user/1/2021/02
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"totalIncome": "300.00",
"totalOutcome": "2696.50",
"lastOutcome": "0.00",
"dayBillLists": [
{
"time": "2021-02-02 星期二",
"money": "支出：130.50 收入：0.00",
"list": [
{
"bid": 1,
"cost": 70.5,
"content": "历史书",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1612245506000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "居家",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 2,
"cost": 60.0,
"content": "政治书",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1612245498000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "饮料",
"sortImg": null,
"priority": null,
"income": false
}
}
]
},
{
"time": "2021-02-05 星期五",
"money": "支出：550.00 收入：0.00",
"list": [
{
"bid": 73,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502012000,
"income": false,
"version": 0,
"sort": {
"sortId": 1,
"uid": 1,
"sortName": "兼职",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 72,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502009000,
"income": false,
"version": 0,
"sort": {
"sortId": 1,
"uid": 1,
"sortName": "添加",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 59,
"cost": 200.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502007000,
"income": false,
"version": 0,
"sort": {
"sortId": 1,
"uid": 1,
"sortName": "住房",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 57,
"cost": 50.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502006000,
"income": false,
"version": 0,
"sort": {
"sortId": 1,
"uid": 1,
"sortName": "娱乐",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 4,
"cost": 100.0,
"content": null,
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502003000,
"income": false,
"version": 0,
"sort": {
"sortId": 1,
"uid": 1,
"sortName": "旅行",
"sortImg": null,
"priority": null,
"income": false
}
}
]
},
{
"time": "2021-02-06 星期六",
"money": "支出：350.00 收入：300.00",
"list": [
{
"bid": 75,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 5,
"sortId": 40,
"crDate": 1612616325000,
"income": true,
"version": 0,
"sort": {
"sortId": 40,
"uid": 1,
"sortName": "兼职",
"sortImg": null,
"priority": null,
"income": true
}
},
{
"bid": 74,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 5,
"sortId": 41,
"crDate": 1612616321000,
"income": true,
"version": 0,
"sort": {
"sortId": 41,
"uid": 1,
"sortName": "添加",
"sortImg": null,
"priority": null,
"income": true
}
},
{
"bid": 71,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 41,
"crDate": 1612616318000,
"income": true,
"version": 0,
"sort": {
"sortId": 41,
"uid": 1,
"sortName": "住房",
"sortImg": null,
"priority": null,
"income": true
}
},
{
"bid": 58,
"cost": 250.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 3,
"crDate": 1612615692000,
"income": false,
"version": 0,
"sort": {
"sortId": 3,
"uid": 1,
"sortName": "娱乐",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 5,
"cost": 100.0,
"content": null,
"uid": 1,
"payId": 1,
"sortId": 2,
"crDate": 1612615688000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "旅行",
"sortImg": null,
"priority": null,
"income": false
}
}
]
},
{
"time": "2021-02-15 星期一",
"money": "支出：555.00 收入：0.00",
"list": [
{
"bid": 76,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613393907000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "维修",
"sortImg": null,
"priority": null,
"income": false
}
}
]
},
{
"time": "2021-02-16 星期二",
"money": "支出：1111.00 收入：0.00",
"list": [
{
"bid": 78,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "医疗",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 77,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 0,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "长辈",
"sortImg": null,
"priority": null,
"income": false
}
},
{
"bid": 79,
"cost": 1.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 2,
"sort": {
"sortId": 2,
"uid": 1,
"sortName": "添加",
"sortImg": null,
"priority": null,
"income": false
}
}
]
}
]
}
[/collapse]
1.2 每月账单详情2
返回每月账单图标详情，按账单类型归类
必选参数: /{uid}/{Year}/{Month}
- uid: 用户id
- Year : 年份
- Month ： 月份
接口地址:
bill/chart
调用例子:
http://bill.jiuyexd.cn/bill/chart/1/2021/02
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"totalOut": "2696.50",
"totalIn": "300.00",
"lastTotalOut": 0.00,
"lastTotalIn": 0.00,
"outSortList": [
{
"backColor": "#2A7A42",
"money": "550.00",
"sort": {
"sortId": 1,
"uid": 0,
"sortName": "偿还费用",
"sortImg": null,
"priority": 0,
"income": false
},
"list": [
{
"bid": 73,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502012000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 72,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502009000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 59,
"cost": 200.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502007000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 57,
"cost": 50.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502006000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 4,
"cost": 100.0,
"content": null,
"uid": 1,
"payId": 1,
"sortId": 1,
"crDate": 1612502003000,
"income": false,
"version": 0,
"sort": null
}
]
},
{
"backColor": "#CD875D",
"money": "1896.50",
"sort": {
"sortId": 2,
"uid": 0,
"sortName": "手续费",
"sortImg": null,
"priority": null,
"income": false
},
"list": [
{
"bid": 77,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 78,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 79,
"cost": 1.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613480307000,
"income": false,
"version": 2,
"sort": null
},
{
"bid": 76,
"cost": 555.0,
"content": "test",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1613393907000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 5,
"cost": 100.0,
"content": null,
"uid": 1,
"payId": 1,
"sortId": 2,
"crDate": 1612615688000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 1,
"cost": 70.5,
"content": "历史书",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1612245506000,
"income": false,
"version": 0,
"sort": null
},
{
"bid": 2,
"cost": 60.0,
"content": "政治书",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1612245498000,
"income": false,
"version": 0,
"sort": null
}
]
},
{
"backColor": "#0F1A5C",
"money": "250.00",
"sort": {
"sortId": 3,
"uid": 0,
"sortName": "商城消费",
"sortImg": null,
"priority": null,
"income": false
},
"list": [
{
"bid": 58,
"cost": 250.0,
"content": "null",
"uid": 1,
"payId": 1,
"sortId": 3,
"crDate": 1612615692000,
"income": false,
"version": 0,
"sort": null
}
]
}
],
"inSortList": [
{
"backColor": "#417D31",
"money": "100.00",
"sort": {
"sortId": 40,
"uid": 0,
"sortName": "返现",
"sortImg": null,
"priority": null,
"income": true
},
"list": [
{
"bid": 75,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 5,
"sortId": 40,
"crDate": 1612616325000,
"income": true,
"version": 0,
"sort": null
}
]
},
{
"backColor": "#1ABF10",
"money": "200.00",
"sort": {
"sortId": 41,
"uid": 0,
"sortName": "兼职",
"sortImg": null,
"priority": null,
"income": true
},
"list": [
{
"bid": 74,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 5,
"sortId": 41,
"crDate": 1612616321000,
"income": true,
"version": 0,
"sort": null
},
{
"bid": 71,
"cost": 100.0,
"content": "test",
"uid": 1,
"payId": 1,
"sortId": 41,
"crDate": 1612616318000,
"income": true,
"version": 0,
"sort": null
}
]
}
]
}
[/collapse]
1.3 每月账单3
返回每月账单图标详情，按账单支付方式归类
必选参数: /{uid}/{Year}/{Month}
- uid: 用户id
- Year : 年份
- Month ： 月份
接口地址:
bill/pay
调用例子:
http://bill.jiuyexd.cn/bill/pay/1/2021/02
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"totalOut": "2.00",
"totalIn": "2.00",
"lastTotalOut": 0.00,
"lastTotalIn": 0.00,
"list": [
{
"outcome": null,
"income": null,
"pay": {
"payId": 5,
"uid": 2,
"payName": "储蓄卡",
"payImg": "null",
"payNum": "尾号3719"
}
},
{
"outcome": null,
"income": null,
"pay": {
"payId": 6,
"uid": 2,
"payName": "借记卡",
"payImg": "null",
"payNum": "尾号4214"
}
}
]
}
[/collapse]
1.4 添加账单
返回新增账单
必选参数:
- cost ：账单金额
- content ： 备注
- uid : 用户id
- sortId : 账单分类id
- payId ： 用户支付方式id
- crDate ： 创建时间
- income ： 是否为收入
接口地址:
bill/add
调用例子:
http://bill.jiuyexd.cn/bill/add?cost=1&content=test&uid=2&sortId=3&payId=4&crDate=2021-2-20&income=false
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！"
}
[/collapse]
1.5 修改账单
返回更新的账单
必选参数:
- bid： 账单id
- cost ： 账单金额
- content ： 备注
- uid : 用户id
- sortId : 账单分类id
- payId ： 用户支付方式id
- crDate ： 创建时间
- income ： 是否为收入
接口地址:
bill/update
调用例子:
http://bill.jiuyexd.cn/bill/update?bid=80&cost=99&content=test&uid=2&sortId=41&payId=6&crDate=2021-02-21%2020:40:15&income=true
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！"
}
[/collapse]
1.6 删除账单
返回通用信息
必选参数: /{bid}
- bid ： 账单id
接口地址:
bill/delete
调用例子:
http://bill.jiuyexd.cn/bill/delete/56
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！"
}
[/collapse]
1.7 查询账单
返回查询账单
必选参数: /{bid}
- bid ： 账单id
接口地址:
bill/find
调用例子:
http://bill.jiuyexd.cn/bill/find/2
[collapse status=“false” title=“接口返回数据”]
{
"bid": 2,
"cost": 60.0,
"content": "政治书",
"uid": 1,
"payId": 3,
"sortId": 2,
"crDate": 1612245498000,
"income": false,
"version": 0,
"sort": null
}
[/collapse]
2.用户接口
和用户相关操作
2.1 用户登陆
返回用户信息
必选参数:
- username : 用户名
- password : 用户密码
接口地址:
user/login
调用例子:
http://bill.jiuyexd.cn/user/login?username=admin&password=admin
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"uid": 3,
"username": "admin",
"password": "3E3E6B0E5C1C68644FC5CE3CF060211D",
"sex": "女",
"mail": "test@Mail.com",
"mailCode": null,
"avatar": "",
"status": 0
}
2.2 用户注册
返回用户注册信息，但须登陆注册邮箱激活
必选参数:
- username : 用户名
- password : 用户密码
- mail : 用户注册邮箱
接口地址:
user/sign
调用例子:
http://bill.jiuyexd.cn/user/register?username=admin&password=admin&mail=1129755380@qq.com
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 200,
"message": "用户名已存在",
"uid": null,
"username": "admin",
"password": "admin",
"sex": null,
"mail": "1129755380@qq.com",
"mailCode": null,
"avatar": null,
"status": null
}
[/collapse]
2.3 修改用户信息
返回更新后的用户信息
必选参数:
- uid : 用户id
- username : 用户名
- sex: 用户性别（男 & 女）
- mail : 用户邮箱
接口地址:
user/update
调用例子:
http://bill.jiuyexd.cn/user/update?uid=1&username=test&sex=男&mail=test@qq.com&avatar=test
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"uid": 1,
"username": "test",
"password": "test",
"sex": "男",
"mail": "test@qq.com",
"mailCode": "aaa",
"avatar": "test",
"status": 0
}
[/collapse]
2.4 忘记密码
返回通用信息
必选参数:
- username : 用户名
- mail : 用户邮箱
接口地址:
user/forgetPw
调用例子:
http://bill.jiuyexd.cn/user/forgetPw?username=Jiuye&mail=1129755380@qq.com
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"uid": 2,
"username": "Jiuye",
"password": "292559931BF9E3886B303ACBCEC06F21",
"sex": "男",
"mail": "1129755380@qq.com",
"mailCode": "473451",
"avatar": null,
"status": 1
}
[/collapse]
2.5 忘记密码后重置密码
返回用户信息
必选参数:
- username : 用户名
- password ： 新密码
- mailCode : 邮箱中的验证码
接口地址:
user/changePw
调用例子:
http://bill.jiuyexd.cn/user/changePw?username=Jiuye&password=jiuye233&code=473451
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"uid": 2,
"username": "Jiuye",
"password": "292559931BF9E3886B303ACBCEC06F21",
"sex": "男",
"mail": "1129755380@qq.com",
"mailCode": "587390",
"avatar": null,
"status": 1
}
[/collapse]
3.文件接口
和文件相关操作
3.1 上传头像
返回 方式 POST
必选参数:
- file : 用户头像文件
接口地址:
file/upload
调用例子:
http://bill.jiuyexd.cn/file/upload
测试地址:
http://bill.jiuyexd.cn/file/test
文件地址:
http://bill.jiuyexd.cn/upload/avatar.png
[collapse status=“false” title=“接口返回数据”]
ok
[/collapse]
4.分类接口
和账单分类以及支付信息相关操作
4.1 用户账单分类以及支付信息查询
返回账单分类以及支付信息数据 其中sort账单分类以及用户支付方式的uid(用户id)有两种：0代表系统设置，其余对应用户id
必选参数: /{uid}
- uid : 用户id
接口地址:
note/user
调用例子:
http://bill.jiuyexd.cn/note/user/1
[collapse status=“false” title=“接口返回数据”]
{
"statusCode": 100,
"message": "处理成功！",
"outSorts": [
{
"sortId": 1,
"uid": 0,
"sortName": "偿还费用",
"sortImg": null,
"priority": 0,
"income": false
},
{
"sortId": 2,
"uid": 0,
"sortName": "手续费",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 3,
"uid": 0,
"sortName": "商城消费",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 4,
"uid": 0,
"sortName": "违约金",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 5,
"uid": 0,
"sortName": "住房",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 6,
"uid": 0,
"sortName": "办公",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 7,
"uid": 0,
"sortName": "餐饮",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 8,
"uid": 0,
"sortName": "医疗",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 10,
"uid": 0,
"sortName": "运动",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 11,
"uid": 0,
"sortName": "娱乐",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 12,
"uid": 0,
"sortName": "居家",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 13,
"uid": 0,
"sortName": "宠物",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 14,
"uid": 0,
"sortName": "数码",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 15,
"uid": 0,
"sortName": "捐赠",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 16,
"uid": 0,
"sortName": "零食",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 17,
"uid": 0,
"sortName": "孩子",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 18,
"uid": 0,
"sortName": "长辈",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 19,
"uid": 0,
"sortName": "礼物",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 20,
"uid": 0,
"sortName": "学习",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 21,
"uid": 0,
"sortName": "水果",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 22,
"uid": 0,
"sortName": "美容",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 23,
"uid": 0,
"sortName": "维修",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 24,
"uid": 0,
"sortName": "旅行",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 25,
"uid": 0,
"sortName": "交通",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 26,
"uid": 0,
"sortName": "饮料",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 27,
"uid": 0,
"sortName": "礼金",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 28,
"uid": 1,
"sortName": "吃啊",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 29,
"uid": 1,
"sortName": "xxx",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 30,
"uid": 1,
"sortName": "爱情",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 31,
"uid": 1,
"sortName": "新年快乐",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 32,
"uid": 1,
"sortName": "阿卡丽",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 33,
"uid": 0,
"sortName": "添加",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 46,
"uid": 1,
"sortName": "ceshi",
"sortImg": null,
"priority": null,
"income": false
},
{
"sortId": 47,
"uid": 1,
"sortName": "ceshi2",
"sortImg": null,
"priority": null,
"income": false
}
],
"inSorts": [
{
"sortId": 34,
"uid": 0,
"sortName": "礼金",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 35,
"uid": 0,
"sortName": "加息",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 36,
"uid": 0,
"sortName": "佣金奖励",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 37,
"uid": 0,
"sortName": "额外收益",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 38,
"uid": 0,
"sortName": "资金补偿",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 39,
"uid": 0,
"sortName": "利息",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 40,
"uid": 0,
"sortName": "返现",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 41,
"uid": 0,
"sortName": "兼职",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 42,
"uid": 1,
"sortName": "其他",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 43,
"uid": 1,
"sortName": "添加3",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 44,
"uid": 1,
"sortName": "吃饭",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 45,
"uid": 0,
"sortName": "添加",
"sortImg": null,
"priority": null,
"income": true
},
{
"sortId": 48,
"uid": 1,
"sortName": "ceshi2",
"sortImg": null,
"priority": null,
"income": true
}
],
"payinfo": [
{
"payId": 4,
"uid": 1,
"payName": "借记卡",
"payImg": "null",
"payNum": "尾号0047"
}
]
}
[/collapse]