github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity

修正获取用户持有的粉丝勋章 api (#303)

Browse Source
This commit is contained in:
OceanJiang 2022-01-28 20:05:20 +08:00 committed by GitHub
parent b6c8e84d7d
commit b6c4523eca
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 111 additions and 213 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

324
live/user.md
View File

@ -1,6 +1,6 @@
# 直播间用户实用API
# 直播间用户实用 API
- [直播间用户实用API](#直播间用户实用api)
- [直播间用户实用 API](#直播间用户实用-api)
- [获取用户持有的粉丝勋章信息](#获取用户持有的粉丝勋章信息)
- [佩戴勋章](#佩戴勋章)
- [直播签到](#直播签到)
@ -9,121 +9,75 @@
## 获取用户持有的粉丝勋章信息
> http://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal
> ~~http://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal~~
>
> https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals
*请求方式：GET*
_请求方式：GET_
认证方式：Cookie（SESSDATA）或APP
认证方式：Cookie（SESSDATA）或 APP
**url参数：**
**url 参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| page | num | 返回结果页数 | 非必要 | 返回结果单页最大为10 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ------------ | ------ | ------------------------------------------------- |
| page_size | num | 每页的数量 | 必要 | 最大为 10，超出 `1002002：参数异常` |
| page | num | 返回结果页数 | 必要 | 两个参数不填返回空，只 page 不填或错误则 500 异常 |
**json回复：**
**json 回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br>-400：请求错误 |
| message | str | 错误信息 | 默认为空("") |
| msg | str | 错误信息 | 默认为空("") |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br>-1002002：参数异常<br>-500：服务器异常 |
| message | str | 错误信息 | 默认为 "0" |
| ttl | str | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| medalCount | num | 勋章数量 | |
| count | num | 勋章数量 | |
| fansMedalList | array | 粉丝勋章信息本体 | |
| name | str | 用户名 | |
| pageinfo | obj | 页码信息 | |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | ---------------- | ---- |
| count | num | 勋章数量 | |
| items | array | 粉丝勋章信息本体 | |
| page_info | obj | 页码信息 | |
`fansMedalList 数组内`对象：
`items 数组内`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| 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 | 直播间房间号 | |
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ------ | -------------------- | -------------------------------------- |
| can_delete | bool | 可否删除 | |
| day_limit | num | 日经验上限（原力值） | eg: 1500 |
| guard_level | num | | |
| guard_medal_title | str | 加成状态 | |
| intimacy | num | 当前已得亲密度 | |
| is_lighted | num | 是否点亮 | 0：未点亮<br>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 主用户名 | |
`pageinfo`对象：
`page_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| 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 | 认证信息 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------- | ---- |
| total_page | num | 页码总长度 | |
| cur_page | num | 当前返回的页码 | |
**示例：**
```shell
curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&page_size=10 \
-b "SESSDATA=xxx"
```
@ -132,93 +86,39 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
```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
}
}
"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
}
}
```
@ -228,30 +128,30 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
> http://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear
*请求方式：POST*
_请求方式：POST_
**表单参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------------- | ---- | ---- |
| medal_id | num | 勋章id | 必要 | |
| csrf | num | cookie中bili_jct字段 | 必要 | |
| csrf_token | num | 同上 | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ----------------------- | ------ | ---- |
| medal_id | num | 勋章 id | 必要 | |
| csrf | num | cookie 中 bili_jct 字段 | 必要 | |
| csrf_token | num | 同上 | 必要 | |
**json回复：**
**json 回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功 |
| ttl | str | 1 | |
| message | str | 错误信息 | 默认为佩戴成功 |
| data | obj | 信息本体 | 默认为无 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------- |
| code | num | 返回值 | 0：成功 |
| ttl | str | 1 | |
| message | str | 错误信息 | 默认为佩戴成功 |
| data | obj | 信息本体 | 默认为无 |
**示例：**
佩戴勋章id为1的勋章
佩戴勋章 id 为 1 的勋章
```JavaScript
var madelForm = new FormData();
@ -280,10 +180,10 @@ $.ajax({
```json
{
"code": 0,
"message": "佩戴成功",
"ttl": 1,
"data": {}
"code": 0,
"message": "佩戴成功",
"ttl": 1,
"data": {}
}
```
@ -293,19 +193,17 @@ $.ajax({
> http://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign
*请求方式：GET*
_请求方式：GET_
认证方式：Cookie（SESSDATA）或APP
认证方式：Cookie（SESSDATA）或 APP
**json回复：**
**json 回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- |
| code | num | 返回值 | 0：成功<br>1：参数错误 |
| ttl | str | 1 | |
| message | str | 错误信息 | 默认为当日签到奖励内容 |
| data | obj | 信息本体 | 默认为空 |
| code | num | 返回值 | 0：成功<br>1：参数错误 |
| ttl | str | 1 | |
| message | str | 错误信息 | 默认为当日签到奖励内容 |
| data | obj | 信息本体 | 默认为空 |