记个糊涂账 API

Author： JiuyeXD
发布时间：February 20, 2021
1934 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-e2921b7a94311f1205919b58192b74811" 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-e2921b7a94311f1205919b58192b74811" 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-f3d764fcca3117b2e2c6b61e55d2f54c43" 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-f3d764fcca3117b2e2c6b61e55d2f54c43" 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-7a728688ddc9e83978b077a918b1c13557" 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-7a728688ddc9e83978b077a918b1c13557" 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-8738a3bd42613056df36fb2d3bd63a3179" 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-8738a3bd42613056df36fb2d3bd63a3179" 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-952e1da4271e3482b4c41df6a1d4882e15" 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-952e1da4271e3482b4c41df6a1d4882e15" 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-54b79cbb48fc0b617d43aed164687dc05" 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-54b79cbb48fc0b617d43aed164687dc05" 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-c5870a38ec261889d21237028a4df6a175" 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-c5870a38ec261889d21237028a4df6a175" 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-2739cd33e667fe97f65d8cd3b7983b8059" 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-2739cd33e667fe97f65d8cd3b7983b8059" 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-b7316afa96c6f43c441cc267a7a1f47770" 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-b7316afa96c6f43c441cc267a7a1f47770" 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-887cb3876d9905ca9ec65b665728de0c57" 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-887cb3876d9905ca9ec65b665728de0c57" 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-a35ea83036229c383d2ab399efba46b896" 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-a35ea83036229c383d2ab399efba46b896" 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-4424747bfcba6105d60963ea1a2f403964" 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-4424747bfcba6105d60963ea1a2f403964" 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-86aba083f08ff60bc844d321d899bc3a38" 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-86aba083f08ff60bc844d321d899bc3a38" 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-d30c700d6c66277ba1b67373a687f26272" 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-d30c700d6c66277ba1b67373a687f26272" 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-5adad456f21bd4fabf8873b6cd4ef58170" 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-5adad456f21bd4fabf8873b6cd4ef58170" 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-98134e13333a152a1e283dae15b476d431" 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-98134e13333a152a1e283dae15b476d431" 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-e6879a47a68486d99e27a235197170fb55" 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-e6879a47a68486d99e27a235197170fb55" 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-4c8cad8b650eba20f75719da28a430e226" 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-4c8cad8b650eba20f75719da28a430e226" 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-f01cdd6afc1d10bfb40019f2147cf1b764" 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-f01cdd6afc1d10bfb40019f2147cf1b764" 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-759288f653ea8c3705183842650b191332" 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-759288f653ea8c3705183842650b191332" 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-ee6587a9afa187a4555f8f1414c2a49265" 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-ee6587a9afa187a4555f8f1414c2a49265" 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-4d390b1717da1e4262551148cada652a46" 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-4d390b1717da1e4262551148cada652a46" 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-472e7e086cef6306729046e3b6f75ed28" 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-472e7e086cef6306729046e3b6f75ed28" 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-fb0c4e45f943799a252ca3d2b9e3d31092" 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-fb0c4e45f943799a252ca3d2b9e3d31092" 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-569e3fab7a3b23dc24c3f49c5589c0c252" 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-569e3fab7a3b23dc24c3f49c5589c0c252" 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-aa4c6a242142e89b2464c1bf1042f5b680" 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-aa4c6a242142e89b2464c1bf1042f5b680" class="collapse collapse-content"><p></p>

记个糊涂账 API

One comment

Leave a Comment Cancel reply

Hello World

记个糊涂账 API

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

dispatcher-servlet.xml文件配置模板

修改Docker容器默认存储路径

Vue ElementUI中使用<el-autocomplete>标签实现远程搜索下拉框并实现自动填充功能

@RequestParam注解的用法

IntelliJ IDEA插件分享 - GitToolBox(编辑器内显示每一行代码Git的用户和日期)

若依数据权限

SSM搭建Spring单元测试环境

记个糊涂账 API