anchorTask.md 4.2 KB

(主播侧)-我的主播奖励(登录态)

需要登录

GET http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/myReward

请求参数

参数名 必选 类型 描述
page integer 页数
{
    "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 页数
{
    "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 使用平台
{
    "code": 0,
    "message": "ok",
    "data": {
        "result": 0
    }
}

(主播侧)-奖励和任务红点(登录态)

需要登录

GET http://api.live.bilibili.com/xlive/web-ucenter/v1/anchorTask/isViewed

请求参数

参数名 必选 类型 描述
{
    "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 流水单号
{
    "code": 0,
    "message": "ok",
    "data": {
        "result": 0
    }
}