直播间用户实用 API

直播间用户实用 API

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

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

https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url 参数：

参数名	类型	内容	必要性	备注
page_size	num	每页的数量	必要	最大为 10，超出 `1002002：参数异常`
page	num	返回结果页数	必要	两个参数不填返回空，只 page 不填或错误则 500 异常

json 回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -1002002：参数异常 -500：服务器异常
message	str	错误信息	默认为 "0"
ttl	str	1
data	obj	信息本体

data对象：

字段	类型	内容
count	num	勋章数量
items	array	粉丝勋章信息本体
page_info	obj	页码信息

items 数组内对象：

字段	类型	内容	备注
can_delete	bool	可否删除
day_limit	num	日经验上限（原力值）	eg: 1500
guard_level	num
guard_medal_title	str	加成状态
intimacy	num	当前已得亲密度
is_lighted	num	是否点亮	0：未点亮 1：点亮
level	num	勋章等级
medal_name	str	勋章名
medal_color_border	num	勋章边框颜色信息	颜色数值为 10 进制的 16 进制值（下同）
medal_color_start	num	勋章起始颜色	从右往左渐变（20 级+勋章）
medal_color_end	num	勋章结束颜色	从右往左渐变（20 级+勋章）
medal_id	num	粉丝勋章 id
next_intimacy	num	升级所需经验
today_feed	num	本日亲密度
roomid	num	直播间房间号
status	num
target_id	number	up 主 mid
target_name	str	up 主用户名
uname	str	up 主用户名

page_info对象：

字段	类型	内容	备注
total_page	num	页码总长度
cur_page	num	当前返回的页码

示例：

curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&page_size=10 \
-b "SESSDATA=xxx"

查看响应示例：

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "items": [
      {
        "can_deleted": true,
        "day_limit": 1500,
        "guard_level": 0,
        "guard_medal_title": "未开启加成",
        "intimacy": 9617,
        "is_lighted": 0,
        "level": 11,
        "medal_name": "锦依卫",
        "medal_color_border": 12632256,
        "medal_color_end": 12632256,
        "medal_color_start": 12632256,
        "medal_id": 29245,
        "next_intimacy": 10000,
        "today_feed": 0,
        "roomid": 1546736,
        "status": 0,
        "target_id": 36081646,
        "target_name": "洛天依",
        "uname": "洛天依"
      }
    ],
    "page_info": {
      "cur_page": 1,
      "total_page": 1
    },
    "count": 1
  }
}

佩戴勋章

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	信息本体	默认为空

7.1 KiB Raw Blame History Unescape Escape

直播间用户实用 API

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

佩戴勋章

直播签到

7.1 KiB

Raw Blame History