记个糊涂账 API

Author： JiuyeXD
发布时间：February 20, 2021
1587 views
One comment
35917 words
Categories：闲言碎语

### 1.账单接口

> 和账单相关操作

#### 1.1  每月账单详情

> 返回每月账单详情，按天归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份
* **接口地址:**
  `bill/user`

**调用例子:**
`http://bill.jiuyexd.cn/bill/user/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-011c5972bbc54cd7b9c7c7b10bd721ae39" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-011c5972bbc54cd7b9c7c7b10bd721ae39" class="collapse collapse-content"><p></p>

```
{
    "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
                    }
                }
            ]
        }
    ]
}
```

#### 1.2  每月账单详情2

> 返回每月账单图标详情，按账单类型归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份

**接口地址:**
`bill/chart`

**调用例子:**
`http://bill.jiuyexd.cn/bill/chart/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-7683d9c9477f607e1e699a3a20964e0623" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-7683d9c9477f607e1e699a3a20964e0623" class="collapse collapse-content"><p></p>

```
{
    "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
                }
            ]
        }
    ]
}
```

#### 1.3  每月账单3

> 返回每月账单图标详情，按账单支付方式归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份

**接口地址:**
`bill/pay`

**调用例子:**
`http://bill.jiuyexd.cn/bill/pay/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-f90cb348da2649270c0e4498aa9642a350" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-f90cb348da2649270c0e4498aa9642a350" class="collapse collapse-content"><p></p>

```
{
    "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"
            }
        }
    ]
}
```

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-ba019a670d701954096ef921aefc538455" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-ba019a670d701954096ef921aefc538455" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-7343a422e0f72efbcc0aea55b0f6445f65" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-7343a422e0f72efbcc0aea55b0f6445f65" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 1.6  删除账单

> 返回通用信息

**必选参数:**
/{bid}

* bid ： 账单id

**接口地址:**
`bill/delete`

**调用例子:**
`http://bill.jiuyexd.cn/bill/delete/56`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-724982c537d643ba44aef18b4ae9a48325" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-724982c537d643ba44aef18b4ae9a48325" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 1.7  查询账单

> 返回查询账单

**必选参数:**
/{bid}

* bid ： 账单id

**接口地址:**
`bill/find`

**调用例子:**
`http://bill.jiuyexd.cn/bill/find/2`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-31350ff83bd949e858889dd2837b2e4975" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-31350ff83bd949e858889dd2837b2e4975" class="collapse collapse-content"><p></p>

```
{
    "bid": 2,
    "cost": 60.0,
    "content": "政治书",
    "uid": 1,
    "payId": 3,
    "sortId": 2,
    "crDate": 1612245498000,
    "income": false,
    "version": 0,
    "sort": null
}
```

### 2.用户接口

> 和用户相关操作

#### 2.1  用户登陆

> 返回用户信息

**必选参数:**

* username : 用户名
* password : 用户密码

**接口地址:**
`user/login`

**调用例子:**
`http://bill.jiuyexd.cn/user/login?username=admin&password=admin`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-8db48554bbf8a673fe0dc727f45e37d194" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-8db48554bbf8a673fe0dc727f45e37d194" class="collapse collapse-content"><p></p>

```
{
    "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
}
```

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-83b0e2de91faffc1cfec4744a3dbf60a33" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-83b0e2de91faffc1cfec4744a3dbf60a33" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！",
    "uid": 1,
    "username": "test",
    "password": "test",
    "sex": "男",
    "mail": "test@qq.com",
    "mailCode": "aaa",
    "avatar": "test",
    "status": 0
}
```

#### 2.4  忘记密码

> 返回通用信息

**必选参数:**

* username : 用户名
* mail : 用户邮箱

**接口地址:**
`user/forgetPw`

**调用例子:**
`http://bill.jiuyexd.cn/user/forgetPw?username=Jiuye&mail=1129755380@qq.com`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-261279a9562e78edc547fae73bf47c8e3" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-261279a9562e78edc547fae73bf47c8e3" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！",
    "uid": 2,
    "username": "Jiuye",
    "password": "292559931BF9E3886B303ACBCEC06F21",
    "sex": "男",
    "mail": "1129755380@qq.com",
    "mailCode": "473451",
    "avatar": null,
    "status": 1
}
```

![image.png](https://old.qwq.ro/usr/uploads/2021/02/679775209.png)

#### 2.5 忘记密码后重置密码

> 返回用户信息

**必选参数:**

* username : 用户名
* password ： 新密码
* mailCode : 邮箱中的验证码

**接口地址:**
`user/changePw`

**调用例子:**
`http://bill.jiuyexd.cn/user/changePw?username=Jiuye&password=jiuye233&code=473451`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-d4fba3fb2b31776de9f202491dd42e8681" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-d4fba3fb2b31776de9f202491dd42e8681" class="collapse collapse-content"><p></p>

### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-bdb58be802e6b63363fdf2699214950176" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-bdb58be802e6b63363fdf2699214950176" class="collapse collapse-content"><p></p>

```
ok
```

### 4.分类接口

> 和账单分类以及支付信息相关操作

#### 4.1  用户账单分类以及支付信息查询

> 返回账单分类以及支付信息数据
> 其中sort账单分类以及用户支付方式的uid(用户id)有两种：0代表系统设置，其余对应用户id

**必选参数:**
/{uid}

* uid : 用户id

**接口地址:**
`note/user`

**调用例子:**
`http://bill.jiuyexd.cn/note/user/1`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-ae61bd04f950c15cde035b119b71211911" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-ae61bd04f950c15cde035b119b71211911" class="collapse collapse-content"><p></p>

```
{
    "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"
        }
    ]
}
```

Last modification：February 20, 2021

感谢大佬投喂啾咪~

One comment

九叶
February 21st, 2021 at 10:20 am

Reply

记个糊涂账 API

JiuyeXD • 2021 年 02 月 20 日

### 1.账单接口

> 和账单相关操作

#### 1.1  每月账单详情

> 返回每月账单详情，按天归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份
* **接口地址:**
  `bill/user`

**调用例子:**
`http://bill.jiuyexd.cn/bill/user/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-e8eb1128057fcabb7f751b760ae420c85" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-e8eb1128057fcabb7f751b760ae420c85" class="collapse collapse-content"><p></p>

#### 1.2  每月账单详情2

> 返回每月账单图标详情，按账单类型归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份

**接口地址:**
`bill/chart`

**调用例子:**
`http://bill.jiuyexd.cn/bill/chart/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-e12435492a4ff40f68b31e3e7226c23755" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-e12435492a4ff40f68b31e3e7226c23755" class="collapse collapse-content"><p></p>

#### 1.3  每月账单3

> 返回每月账单图标详情，按账单支付方式归类

**必选参数:**
/{uid}/{Year}/{Month}

* uid: 用户id
* Year : 年份
* Month ： 月份

**接口地址:**
`bill/pay`

**调用例子:**
`http://bill.jiuyexd.cn/bill/pay/1/2021/02`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-e437122e1daa84ea863142d264d8ef2b74" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-e437122e1daa84ea863142d264d8ef2b74" class="collapse collapse-content"><p></p>

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-cfc4ef7d25c969757be038e1c011608c91" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-cfc4ef7d25c969757be038e1c011608c91" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-5e73d533289cf3d51cf147556b9de98789" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-5e73d533289cf3d51cf147556b9de98789" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 1.6  删除账单

> 返回通用信息

**必选参数:**
/{bid}

* bid ： 账单id

**接口地址:**
`bill/delete`

**调用例子:**
`http://bill.jiuyexd.cn/bill/delete/56`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-b5ca9ee43ea64f201b1b2b336d288e1c68" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-b5ca9ee43ea64f201b1b2b336d288e1c68" class="collapse collapse-content"><p></p>

```
{
    "statusCode": 100,
    "message": "处理成功！"
}
```

#### 1.7  查询账单

> 返回查询账单

**必选参数:**
/{bid}

* bid ： 账单id

**接口地址:**
`bill/find`

**调用例子:**
`http://bill.jiuyexd.cn/bill/find/2`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-fff70b53cb94bedaae2f59145a1d6c7456" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-fff70b53cb94bedaae2f59145a1d6c7456" class="collapse collapse-content"><p></p>

### 2.用户接口

> 和用户相关操作

#### 2.1  用户登陆

> 返回用户信息

**必选参数:**

* username : 用户名
* password : 用户密码

**接口地址:**
`user/login`

**调用例子:**
`http://bill.jiuyexd.cn/user/login?username=admin&password=admin`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-751b05313107d843cdfe60332bf9887c46" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-751b05313107d843cdfe60332bf9887c46" class="collapse collapse-content"><p></p>

#### 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="接口返回数据"]

#### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-2c33f3ac05f28d1df73c903a0a381bb046" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-2c33f3ac05f28d1df73c903a0a381bb046" class="collapse collapse-content"><p></p>

#### 2.4  忘记密码

> 返回通用信息

**必选参数:**

* username : 用户名
* mail : 用户邮箱

**接口地址:**
`user/forgetPw`

**调用例子:**
`http://bill.jiuyexd.cn/user/forgetPw?username=Jiuye&mail=1129755380@qq.com`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-b4c7a978fabf669a11b1064e1a960d6427" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-b4c7a978fabf669a11b1064e1a960d6427" class="collapse collapse-content"><p></p>

![image.png](https://old.qwq.ro/usr/uploads/2021/02/679775209.png)

#### 2.5 忘记密码后重置密码

> 返回用户信息

**必选参数:**

* username : 用户名
* password ： 新密码
* mailCode : 邮箱中的验证码

**接口地址:**
`user/changePw`

**调用例子:**
`http://bill.jiuyexd.cn/user/changePw?username=Jiuye&password=jiuye233&code=473451`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-e1d914b9c0351bb6294f98a7e3d3dc213" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-e1d914b9c0351bb6294f98a7e3d3dc213" class="collapse collapse-content"><p></p>

### 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`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-50a3313ab8c1fde8a5107b07a87f4ec673" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-50a3313ab8c1fde8a5107b07a87f4ec673" class="collapse collapse-content"><p></p>

```
ok
```

### 4.分类接口

> 和账单分类以及支付信息相关操作

#### 4.1  用户账单分类以及支付信息查询

> 返回账单分类以及支付信息数据
> 其中sort账单分类以及用户支付方式的uid(用户id)有两种：0代表系统设置，其余对应用户id

**必选参数:**
/{uid}

* uid : 用户id

**接口地址:**
`note/user`

**调用例子:**
`http://bill.jiuyexd.cn/note/user/1`

<div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-5aea39d74f14740cd1f31f58b2d3d84248" aria-expanded="true"><div class="accordion-toggle"><span>接口返回数据</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-5aea39d74f14740cd1f31f58b2d3d84248" class="collapse collapse-content"><p></p>

记个糊涂账 API

One comment

Leave a Comment Cancel reply

Hello World

Minecraft | [1.12.2] 核电工艺模拟器 1.2.25 —— 汉化版

记个糊涂账 API

dispatcher-servlet.xml文件配置模板

SSM搭建Spring单元测试环境

Itext7 API总结

Springcloud自动注入service的时候提示Consider defining a bean of type 'xxxx' in your configuration.

Lombok自动注入Service

Vue中给表单内元素赋值后视图层rules验证依旧未通过

此内容被密码保护

记个糊涂账 API