# ssmSmartdevice

**Repository Path**: skk77/ssm-smartdevice

## Basic Information

- **Project Name**: ssmSmartdevice
- **Description**: ssm框架编写的电灯控制系统
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-26
- **Last Updated**: 2021-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目文档

### 接口文档

#### 1.1  状态码

> 在我们的项目中相同的状态总是返回相同的状态码，不管是在那个接口中

| 状态码 |                    状态介绍                     |
| :----: | :---------------------------------------------: |
|   1    |                      成功                       |
|   0    |               未知异常导致的失败                |
|   2    |                  用户已经存在                   |
|   3    |                用户名或密码错误                 |
|   4    |               数据不符合接口要求                |
|   5    |                  没有传递数据                   |
|   6    |       删除数据的时候数据不为空，无法删除        |
|   7    |                    设备离线                     |
|  401   | 未登录(值和 http 的状态码一致,但是它不是状态码) |

#### 1.2  菜单列表

> 本接口的作用是返回所有的菜单列表在页面上

##### 1.2.1 请求地址

> GET:menus/munes

##### 1.2.2 参数列表

> 无

##### 1.2.3 返回内容

```json
{
    "msg": "success", //返回状态介绍
    "code": 1 //状态码
    "result": [ //返回内容
        {
            "id": 1, //菜单id
            "url": "/users.html", //请求地址
            "name": "用户列表" //菜单名字
        },
        {
            "id": 2,
            "url": "/categories.html",
            "name": "设备分类"
        },
        {
            "id": 3,
            "url": "/areas.html",
            "name": "区域列表"
        },
        {
            "id": 4,
            "url": "/devices.html",
            "name": "设备列表"
        },
        {
            "id": 5,
            "url": "/humiture.html",
            "name": "温湿度表"
        }
    ]
}
```

#### 1.3 用户列表

##### 1.3.1 请求地址

> GET:users/users

##### 1.3.2

> 参数列表

| 参数名 | 是否必填 |            参数介绍             |
| :----: | :------: | :-----------------------------: |
|  page  |    否    |     分页的当前页码，默认为1     |
| limit  |    否    | 每页需要显示多少条数据,默认为10 |
|        |          |                                 |

##### 1.3.3 返回内容

```json
{
  "msg": "success",
  "code": 1,
  "result": {
    "total": 14,
    "list": [
      {
        "id": 1,
        "username": "admin",
        "lastlogin": "2020-12-13 19:29:09",
        "currentlogin": "2020-12-13 19:29:09",
        "regdate": "2020-12-08 21:56:41",
        "type": "1",
        "status": "1"
      },
      {
        "id": 2,
        "username": "zhangsan",
        "regdate": "2020-12-08 23:00:55",
        "type": "0",
        "status": "0"
      }
    ],
    "pageNum": 1,
    "pageSize": 2,
    "size": 2,
    "startRow": 1,
    "endRow": 2,
    "pages": 7,
    "prePage": 0,
    "nextPage": 2,
    "isFirstPage": true,
    "isLastPage": false,
    "hasPreviousPage": false,
    "hasNextPage": true,
    "navigatePages": 8,
    "navigatepageNums": [
      1,
      2,
      3,
      4,
      5,
      6,
      7
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 7
  }
}
```