# 用户日志模块

控制层 TypechoUserlogController 同时负责用户的收藏，点赞，打赏和签到 @author buxia97 @date 2022/01/06

**类路径**：`UserlogController`
**前缀**：`/typechoUserlog`

## 1. isMark

**接口路径**：`GET/POST /typechoUserlog/isMark`

**权限**：需要登录（普通用户及以上）

**接口说明**：查询用户是否收藏

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| cid | String | 否 | 0 |  |
| type | String | 否 | content |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.getIsMark()  （https://api.ruletree.club/typechoUserlog/isMark）

---

## 2. markList

**接口路径**：`GET/POST /typechoUserlog/markList`

**权限**：需要登录（普通用户及以上）

**接口说明**：查询用户收藏列表，文章、帖子、动态、商品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.getMarkList()  （https://api.ruletree.club/typechoUserlog/markList）

---

## 3. rewardList

**接口路径**：`GET/POST /typechoUserlog/rewardList`

**权限**：需要登录（普通用户及以上）

**接口说明**：查询用户打赏历史 @param page         页码 @param limit        每页显示数量

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.rewardList()  （https://api.ruletree.club/typechoContents/rewardList）

---

## 4. addLog

**接口路径**：`GET/POST /typechoUserlog/addLog`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：添加log @param params Bean对象JSON字符串

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| params | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.addLog()  （https://api.ruletree.club/typechoUserlog/addLog）

---

## 5. removeLog

**接口路径**：`GET/POST /typechoUserlog/removeLog`

**权限**：需要登录（普通用户及以上）

**接口说明**：表单删除

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| key | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.removeLog()  （https://api.ruletree.club/typechoUserlog/removeLog）

---

## 6. orderList

**接口路径**：`GET/POST /typechoUserlog/orderList`

**权限**：需要登录（普通用户及以上）

**接口说明**：查询用户购买订单

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.orderList()  （https://api.ruletree.club/typechoUserlog/orderList）

---

## 7. orderSellList

**接口路径**：`GET/POST /typechoUserlog/orderSellList`

**权限**：需要登录（普通用户及以上）

**接口说明**：查询售出订单列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.orderSellList()  （https://api.ruletree.club/typechoUserlog/orderSellList）

---

## 8. adsGift

**接口路径**：`GET/POST /typechoUserlog/adsGift`

**权限**：需要登录（普通用户及以上）

**接口说明**：发起广告

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |
| appkey | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.adsGift()  （https://api.ruletree.club/typechoUserlog/adsGift）

---

## 9. adsGiftNotify

**接口路径**：`GET/POST /typechoUserlog/adsGiftNotify`

**权限**：需要登录（普通用户及以上）

**接口说明**：广告回调(旧前端回调)

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |
| logid | String | 否 | - |  |
| type | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.adsGift()  （https://api.ruletree.club/typechoUserlog/adsGift）
- 前端调用：this.$API.adsGiftNotify()  （https://api.ruletree.club/typechoUserlog/adsGiftNotify）

---

## 10. adsServerNotify

**接口路径**：`GET/POST /typechoUserlog/adsServerNotify`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：广告回调（服务端模式）

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| adpid | String | 否 | - |  |
| provider | String | 否 | - |  |
| sign | String | 否 | - |  |
| trans_id | String | 否 | - |  |
| user_id | String | 否 | - |  |
| extra | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 11. dataClean

**接口路径**：`GET/POST /typechoUserlog/dataClean`

**权限**：需要超级管理员权限

**接口说明**：查询商品是否已经购买过

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| clean | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.dataClean()  （https://api.ruletree.club/typechoUserlog/dataClean）

---

## 12. ban

**接口路径**：`GET/POST /typechoUserlog/ban`

**权限**：需要登录（普通用户及以上）

**接口说明**：拉黑

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| id | Integer | 否 | - |  |
| token | String | 否 | - |  |
| type | String | 否 | banUser |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.ban()  （https://api.ruletree.club/typechoUserlog/ban）

---

## 13. myBanLog

**接口路径**：`GET/POST /typechoUserlog/myBanLog`

**权限**：需要登录（普通用户及以上）

**接口说明**：拉黑记录

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.ban()  （https://api.ruletree.club/typechoUserlog/ban）
- 前端调用：this.$API.myBanLog()  （https://api.ruletree.club/typechoUserlog/myBanLog）

---

## 14. removeBan

**接口路径**：`GET/POST /typechoUserlog/removeBan`

**权限**：需要登录（普通用户及以上）

**接口说明**：表单删除

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| key | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.ban()  （https://api.ruletree.club/typechoUserlog/ban）
- 前端调用：this.$API.removeBan()  （https://api.ruletree.club/typechoUserlog/removeBan）

---