Create & Init Project...

app/interface/live/web-ucenter/api/http/v1/anchorTask.md

@@ -0,0 +1,187 @@
+## (主播侧)-我的主播奖励(登录态)
+> 需要登录
+
+`GET http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/myReward`
+
+### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|page|否|integer| 页数|
+
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "data": [
+            {
+                //  id
+                "id": 0,
+                //  奖励类型 1:ss推荐卡 2:s推荐卡、任意门
+                "reward_type": 0,
+                //  1:未使用,3:已使用,5:已过期
+                "status": 0,
+                //  奖励id
+                "reward_id": 0,
+                //  奖励名称
+                "name": "",
+                //  奖励图标
+                "icon": "",
+                //  获得时间datetime
+                "achieve_time": "",
+                //  过期时间datetime
+                "expire_time": "",
+                //  来源,1:主播任务,2:小时榜
+                "source": 0,
+                //  奖励简介
+                "reward_intro": ""
+            }
+        ],
+        "page": {
+            //  当前页码
+            "page": 0,
+            //  每页大小
+            "page_size": 0,
+            //  总页数
+            "total_page": 0,
+            //  总记录数
+            "total_count": 0
+        },
+        //  过期奖励数量
+        "expire_count": 0
+    }
+}
+```
+
+## (主播侧)-奖励使用记录(登录态)
+> 需要登录
+
+`GET http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/useRecord`
+
+### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|page|否|integer| 页数|
+
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "data": [
+            {
+                //  id
+                "id": 0,
+                //  奖励id
+                "reward_id": 0,
+                //  1:未使用,3:已使用,5:已过期
+                "status": 0,
+                //  奖励名称
+                "name": "",
+                //  奖励图标
+                "icon": "",
+                //  获得时间datetime
+                "achieve_time": "",
+                //  过期时间datetime
+                "expire_time": "",
+                //  来源,1:主播任务,2:小时榜
+                "source": 0,
+                //  奖励简介
+                "reward_intro": "",
+                //  获得时间datetime
+                "use_time": ""
+            }
+        ],
+        "page": {
+            //  当前页码
+            "page": 0,
+            //  每页大小
+            "page_size": 0,
+            //  总页数
+            "total_page": 0,
+            //  总记录数
+            "total_count": 0
+        }
+    }
+}
+```
+
+## (主播侧)-使用奖励(登录态)
+> 需要登录
+
+`POST http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/useReward`
+
+### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|id|否|integer| 奖励列表id|
+|platform|否|string| 使用平台|
+
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "result": 0
+    }
+}
+```
+
+## (主播侧)-奖励和任务红点(登录态)
+> 需要登录
+
+`GET http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/isViewed`
+
+### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  是否展示任务红点
+        "task_should_notice": 0,
+        //  是否展示奖励入口
+        "show_reward_entry": 0,
+        //  是否展示奖励红点
+        "reward_should_notice": 0,
+        //  任务状态, 0:没有,1:领取, 5:完成
+        "task_status": 0,
+        //  是否在首页黑名单中
+        "is_blacked": 0,
+        //  点击跳转h5链接
+        "url": ""
+    }
+}
+```
+
+## (主播侧)-添加主播奖励(内部接口)
+
+`POST http://api.live.bilibili.com/xlive/internal/web-ucenter/v1/anchorTask/addReward`
+
+### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|reward_id|否|integer| 奖励id, 1:任意门|
+|roomid|否|integer| 房间号|
+|source|否|integer| 来源,1:主播任务,2:小时榜|
+|uid|否|integer| 主播uid|
+|order_id|否|string| 流水单号|
+
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "result": 0
+    }
+}
+```
+