bilibili-API-collect/live/user.md

直播间用户实用API

• 直播间用户实用API
  • 获取用户持有的粉丝勋章信息
  • 佩戴勋章
  • 直播签到

---

获取用户持有的粉丝勋章信息

https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal

请求方式：GET

认证方式：Cookie（SESSDATA）或APP

url参数：

参数名	类型	内容	必要性	备注
page	num	返回结果页数	非必要	返回结果单页最大为10

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为空("")
msg	str	错误信息	默认为空("")
data	obj	信息本体

data对象：

字段	类型	内容	备注
medalCount	num	勋章数量
count	num	勋章数量
fansMedalList	array	粉丝勋章信息本体
name	str	用户名
pageinfo	obj	页码信息

fansMedalList 数组内对象：

字段	类型	内容	备注
uid	num	发起请求的用户mid
target_id	num	up主mid
medal_id	num	粉丝勋章id
score	num
level	num	勋章等级
intimacy	num	当前已得亲密度
status	num
source	num
receive_channel	num	获得方式	2：投币获得 3000：b坷拉
is_receive	num	勋章数量
master_status	num
receive_time	str	勋章获取时间
today_intimacy	num	本日亲密度
last_wear_time	num	上次佩戴时间
is_lighted	num	是否点亮	0：未点亮 1：点亮
medal_level	num	勋章等级
next_intimacy	num	升级所需经验
day_limit	num	日经验上限（原力值）
medal_name	str	勋章名
master_available	num
guard_type	num	加成状态
lpl_status	num
can_delete	bool	可否删除
target_name	str	up主用户名
target_face	str	up主头像
live_stream_status	num	当前直播间放松状态
icon_code	num
icon_text	str
rank	str
medal_color	num	勋章颜色信息	颜色数值为10进制的16进制值（下同）
medal_color_start	num	勋章起始颜色	从右往左渐变（20级+勋章）
medal_color_end	num	勋章结束颜色	从右往左渐变（20级+勋章）
guard_level	num
medal_color_border	num	勋章颜色信息
today_feed	num	本日亲密度
todayFeed	num	同上
dayLimit	num	日经验上限（原力值）
uname	str	up主用户名
color	num	勋章颜色
medalName	str	勋章内容
guard_medal_title	str	加成状态
anchorInfo	obj	up信息
roomid	num	直播间房间号

pageinfo对象：

字段	类型	内容	备注
totalpages	num	页码总长度
curPage	num	当前返回的页码	0：未轮播 1：轮播

anchorInfo对象：

字段	类型	内容	备注
uid	num	up主mid
uname	str	up主用户名
gender	num	性别	0：女 1：男 -1：保密
face	str	up主头像
silence	num	up主禁言状态
masterVip	num	会员类型
masterRank	num	10000
masterLevel	num	up主主站等级
masterHeadpic	str	up主头像框
masterVerify	num
mobileVerified	num	当前返回的页码
identification	num	当前返回的页码
official	obj	认证信息
rank	num	当前返回的页码
platform_user_level	num	up主主站等级
vip_type	num	会员类型
mobile_verify	num
official_verify	obj	认证信息

示例：

curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
-b "SESSDATA=xxx"

查看响应示例：

{
    "code": 0,
    "msg": "",
    "message": "",
    "data": {
        "medalCount": 20,
        "count": 19,
        "fansMedalList": [
            {
                "uid": 1,
                "target_id": 3821157,
                "medal_id": 283582,
                "score": 16031,
                "level": 11,
                "intimacy": 1130,
                "status": 0,
                "source": 1,
                "receive_channel": 3000,
                "is_receive": 1,
                "master_status": 1,
                "receive_time": "2021-07-24 23:06:03",
                "today_intimacy": 252,
                "last_wear_time": 1630386090,
                "is_lighted": 1,
                "medal_level": 11,
                "next_intimacy": 10000,
                "day_limit": 1500,
                "medal_name": "秧歌星",
                "master_available": 1,
                "guard_type": 0,
                "lpl_status": 0,
                "can_delete": true,
                "target_name": "东爱璃Lovely",
                "target_face": "https://i0.hdslb.com/bfs/face/fecabd8cb7cc129fd3bdbc4b71cffec91d342bdd.jpg",
                "live_stream_status": 0,
                "icon_code": 0,
                "icon_text": "",
                "rank": "",
                "medal_color": 9272486,
                "medal_color_start": 9272486,
                "medal_color_end": 9272486,
                "guard_level": 0,
                "medal_color_border": 9272486,
                "today_feed": 252,
                "todayFeed": 252,
                "dayLimit": 1500,
                "uname": "东爱璃Lovely",
                "color": 9272486,
                "medalName": "秧歌星",
                "guard_medal_title": "未开启加成",
                "anchorInfo": {
                    "uid": 3821157,
                    "uname": "东爱璃Lovely",
                    "gender": -1,
                    "face": "https://i0.hdslb.com/bfs/face/fecabd8cb7cc129fd3bdbc4b71cffec91d342bdd.jpg",
                    "silence": 0,
                    "masterVip": 2,
                    "masterRank": 10000,
                    "masterLevel": 6,
                    "masterHeadpic": "https://i0.hdslb.com/bfs/garb/ebe4ac76f95ccb9146fdba2db2723f182ec3276b.png",
                    "masterVerify": 0,
                    "mobileVerified": 1,
                    "identification": 1,
                    "official": {
                        "role": 7,
                        "title": "bilibili 直播高能主播",
                        "desc": ""
                    },
                    "rank": 10000,
                    "platform_user_level": 6,
                    "vip_type": 2,
                    "mobile_verify": 0,
                    "official_verify": {
                        "role": 7,
                        "title": "bilibili 直播高能主播",
                        "desc": "",
                        "type": -1
                    }
                },
                "roomid": 21692711
            }
        ],
        "name": "xxx",
        "pageinfo": {
            "totalpages": 2,
            "curPage": 2
        }
    }
}

佩戴勋章

https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear

请求方式：POST

表单参数：

参数名	类型	内容	必要性	备注
medal_id	num	勋章id	必要
csrf	num	cookie中bili_jct字段	必要
csrf_token	num	同上	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功
ttl	str	1
message	str	错误信息	默认为佩戴成功
data	obj	信息本体	默认为无

示例：

佩戴勋章id为1的勋章

var madelForm = new FormData();
madelForm.append("medal_id", 1);
madelForm.append("csrf", bili_jct);
madelForm.append("csrf_token", bili_jct);
$.ajax({
    url: "https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear",
    type: "POST",
    data: madelForm,
    dataType: "JSON",
    processData: false,
    contentType: false,
    cache: false,
    xhrFields: {
        withCredentials: true
    },
    success: function (){

    }
})

查看响应示例：

{
    "code": 0,
    "message": "佩戴成功",
    "ttl": 1,
    "data": {}
}

直播签到

https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign

请求方式：GET

认证方式：Cookie（SESSDATA）或APP

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 1：参数错误
ttl	str	1
message	str	错误信息	默认为当日签到奖励内容
data	obj	信息本体	默认为空