# 百草视官网

**Repository Path**: SYTTZ/baicaoshi-official-website

## Basic Information

- **Project Name**: 百草视官网
- **Description**: 百草视官网开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-04-03
- **Last Updated**: 2024-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 百草视官网开发

## 网站内容

介绍百草视科技公司与主营业务

## 前后端接口

### 意见反馈

#### 发送意见反馈

将前端用户发送的意见反馈添加到数据库中

##### 请求路径

/contact/add

##### 请求方式

POST

##### 请求参数

```json
{
    "name": name,
    "email": email,
    "subject": subject,
    "message": message
}
```

##### 响应数据

请求报文参数为空

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":false
}
```

数据库插入成功

```json
{
    "code":200,
    "message":"发送成功",
    "data":true
}
```

数据库插入失败

```json
{
    "code":400,
    "message":"发送失败",
    "data":false
}
```

#### 获取所有意见反馈

获取所有意见反馈

##### 请求路径

contact/getAll

##### 请求方式

GET

##### 请求参数

```json
{}
```

##### 响应数据

```json
{
    "code":200,
    "message":"获取意见反馈列表成功",
    "data": [
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
    ]
}
```

```json
{
    "code":400,
    "message":"获取意见反馈列表失败",
    "data": null
}
```

#### 获取当前页意见反馈

通过pageIndex当前页数以及pageSize当前页面数据显示数量来获取意见反馈

##### 请求路径

contact/getPage

##### 请求方式

GET

##### 请求参数

```json
{
    "pageIndex": pageIndex,
    "pageSize": pageSize
}
```

##### 响应数据

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":null
}
```

```json
{
    "code":200,
    "message":"获取当前页意见反馈成功",
    "data": [
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
        {
            "id": id,
            "name": name,
            "email": email,
            "subject": subject,
            "message": message
        },
    ]
}
```

```json
{
    "code":400,
    "message":"获取当前页意见反馈失败",
    "data": null
}
```

##### 提示

MySQL 分页查询

```sql
-- pageSize 页面大小
-- offset 偏移量
select * from contact limit #{pageSize} offset #{offset};
```

offset 偏移量

```java
offset = (pageIndex - 1) * pageSize
```

获取 url 参数

```javascript
function getUrlParam(key) {
    let params = location.search;
    if (params.indexOf("?") >= 0) {
        params = params.substring(1);
        let paramArr = params.split("&");
        for (let i = 0; i < paramArr.length; i++) {
            let values = paramArr[i].split("=");
            if (values[0] == key) {
                return values[1];
            }
        }
    } else {
        return "";
    }
}
```

#### 获取单条意见建议

用 id 获取数据库中的意见反馈

##### 请求路径

contact/get

##### 请求方式

GET

##### 请求参数

```
{
    id
}
```

##### 响应数据

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":null
}
```

```json
{
    "code":200,
    "message":"获取意见建议详情成功",
    "data": {
        "id": id,
        "name": name,
        "email": email,
        "subject": subject,
        "message": message
    }
}
```

```json
{
    "code":400,
    "message":"获取意见建议详情成功失败",
    "data": null
}
```

#### 删除意见建议

用 id 删除数据库中的意见反馈

##### 请求路径

contact/delete

##### 请求方式

POST

##### 请求参数

```json
{
    "id": id
}
```

##### 响应数据

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":false
}
```

```json
{
    "code":200,
    "message":"删除意见建议成功",
    "data": true
}
```

```json
{
    "code":400,
    "message":"删除意见建议失败",
    "data": false
}
```

### 邮箱订阅

#### 用户使用邮箱进行订阅

将 email 添加到数据库中，并发送邮件到他邮箱中

##### 请求路径

subscribe/add

##### 请求方式

POST

##### 请求参数

```json
{
    "email": email
}
```

##### 响应数据

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":false
}
```

```json
{
    "code": 200,
    "message": "订阅成功",
    "data": true
}
```

```json
{
    "code": 400,
    "message": "请勿重复订阅",
    "data": false
}
```

```json
{
    "code": 400,
    "message": "订阅失败",
    "data": false
}
```

#### 取消订阅

用户选择取消订阅

##### 请求路径

subscribe/cancel

##### 请求方式

POST

##### 请求数据

```json
{
    "email": email
}
```

##### 响应数据

```json
{
    "code":400,
    "message":"请求参数错误",
    "data":false
}
```

```json
{
    "code": 200,
    "message": "取消订阅成功",
    "data": true
}
```

```json
{
    "code": 400,
    "message": "取消订阅失败",
    "data": false
}
```