mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-27 13:00:29 +08:00
2f57550ac4
* Update info.md * Update info.md * Update info.md * Update info.md * Update info.md * Update info.md * add user api under live folder * Update info.md * Update user.md * test index * text index * Update README.md * text indexs * update indexs * update Index * update index * update index * update index * update index * update index * 稍微建设了一下目录 * 稍微建设了一下目录 * add vip * 添加大会员福利兑换相关API
312 lines
12 KiB
Markdown
312 lines
12 KiB
Markdown
# 直播间用户实用API
|
||
|
||
- [直播间用户实用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：成功<br>-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：投币获得<br>3000：b坷拉 |
|
||
| is_receive | num | 勋章数量 | |
|
||
| master_status | num | | |
|
||
| receive_time | str | 勋章获取时间 | |
|
||
| today_intimacy | num | 本日亲密度 | |
|
||
| last_wear_time | num | 上次佩戴时间 | |
|
||
| is_lighted | num | 是否点亮 | 0：未点亮<br>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：未轮播<br>1：轮播 |
|
||
|
||
`anchorInfo`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------------- | ---- | ---------------- | ------------------------ |
|
||
| uid | num | up主mid | |
|
||
| uname | str | up主用户名 | |
|
||
| gender | num | 性别 | 0：女<br>1：男<br/>-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 | 认证信息 | |
|
||
|
||
**示例：**
|
||
|
||
```shell
|
||
curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
|
||
-b "SESSDATA=xxx"
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"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
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 佩戴勋章
|
||
|
||
> 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的勋章
|
||
|
||
```JavaScript
|
||
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 (){
|
||
|
||
}
|
||
})
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "佩戴成功",
|
||
"ttl": 1,
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 直播签到
|
||
|
||
> https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：Cookie（SESSDATA）或APP
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ---------------------- |
|
||
| code | num | 返回值 | 0：成功<br>1：参数错误 |
|
||
| ttl | str | 1 | |
|
||
| message | str | 错误信息 | 默认为当日签到奖励内容 |
|
||
| data | obj | 信息本体 | 默认为空 |
|
||
|
||
|