角色板块点赞
请求 URL:
/starRolePlate
请求方式: POST
认证: 需要登录,请在请求头携带有效的 Authorization。
1. 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | App ID |
| udid | 是 | string | 设备 UDID |
| plateId | 是 | uint | 板块 ID,必须大于 0 |
2. 请求示例
{
"appId": "com.example.app",
"udid": "device-udid",
"plateId": 2
}
3. 返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": {
"plateId": 2,
"star": 129
}
}
4. 返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| msg | string | 提示信息 |
| data | object | 点赞结果 |
| data.plateId | uint | 板块 ID |
| data.star | uint | 增加后的最新点赞数 |
5. 接口说明
- 每次成功请求会通过数据库原子操作将对应板块的
star增加 1。 - 已删除或不存在的板块不会增加点赞数。
- 当前没有记录用户与板块的点赞关系,因此同一用户可以多次调用并增加点赞数。
6. 常见状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 510 | 系统错误 |
| 670 | 登录失效 |
| 800 | 参数错误 |
| 900 | 板块不存在或已删除 |