admin/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions 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
1 changed files with 111 additions and 213 deletions
Download Patch File Download Diff File Expand all files Collapse all files

252
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：请求错误 | | code | num | 返回值 | 0：成功<br>-1002002：参数异常<br>-500：服务器异常 |
| message | str | 错误信息 | 默认为空("") | | message | str | 错误信息 | 默认为 "0" |
| msg | str | 错误信息 | 默认为空("") | | ttl | str | 1 | |
| data | obj | 信息本体 | | | data | obj | 信息本体 | |
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ | | --------- | ----- | ---------------- | ---- |
| medalCount | num | 勋章数量 | |
| count | num | 勋章数量 | | | count | num | 勋章数量 | |
| fansMedalList | array | 粉丝勋章信息本体 | | | items | array | 粉丝勋章信息本体 | |
| name | str | 用户名 | | | page_info | obj | 页码信息 | |
| pageinfo | 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 | 可否删除 | | | can_delete | bool | 可否删除 | |
| target_name | str | up主用户名 | | | day_limit | num | 日经验上限（原力值） | eg: 1500 |
| 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 | | | | 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 | 加成状态 | | | guard_medal_title | str | 加成状态 | |
| anchorInfo | obj | up信息 | | | 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 | 直播间房间号 | | | roomid | num | 直播间房间号 | |
| status | num | | |
| target_id | number | up 主 mid | |
| target_name | str | up 主用户名 | |
| uname | str | up 主用户名 | |
`pageinfo`对象： `page_info`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ | | ---------- | ---- | -------------- | ---- |
| totalpages | num | 页码总长度 | | | total_page | num | 页码总长度 | |
| curPage | num | 当前返回的页码 | 0：未轮播<br>1：轮播 | | cur_page | num | 当前返回的页码 | |
`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 ```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" -b "SESSDATA=xxx"
``` ```
@@ -133,91 +87,37 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
```json ```json
{ {
"code": 0, "code": 0,
"msg": "", "message": "0",
"message": "", "ttl": 1,
"data": { "data": {
"medalCount": 20, "items": [
"count": 19,
"fansMedalList": [
{ {
"uid": 1, "can_deleted": true,
"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, "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, "guard_level": 0,
"medal_color_border": 9272486,
"today_feed": 252,
"todayFeed": 252,
"dayLimit": 1500,
"uname": "东爱璃Lovely",
"color": 9272486,
"medalName": "秧歌星",
"guard_medal_title": "未开启加成", "guard_medal_title": "未开启加成",
"anchorInfo": { "intimacy": 9617,
"uid": 3821157, "is_lighted": 0,
"uname": "东爱璃Lovely", "level": 11,
"gender": -1, "medal_name": "锦依卫",
"face": "https://i0.hdslb.com/bfs/face/fecabd8cb7cc129fd3bdbc4b71cffec91d342bdd.jpg", "medal_color_border": 12632256,
"silence": 0, "medal_color_end": 12632256,
"masterVip": 2, "medal_color_start": 12632256,
"masterRank": 10000, "medal_id": 29245,
"masterLevel": 6, "next_intimacy": 10000,
"masterHeadpic": "https://i0.hdslb.com/bfs/garb/ebe4ac76f95ccb9146fdba2db2723f182ec3276b.png", "today_feed": 0,
"masterVerify": 0, "roomid": 1546736,
"mobileVerified": 1, "status": 0,
"identification": 1, "target_id": 36081646,
"official": { "target_name": "洛天依",
"role": 7, "uname": "洛天依"
"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", "page_info": {
"pageinfo": { "cur_page": 1,
"totalpages": 2, "total_page": 1
"curPage": 2 },
} "count": 1
} }
} }
``` ```
@@ -228,22 +128,22 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
> http://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear > http://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear
*请求方式：POST* _请求方式：POST_
**表单参数：** **表单参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------------- | ---- | ---- | | ---------- | ---- | ----------------------- | ------ | ---- |
| medal_id | num | 勋章id | 必要 | | | medal_id | num | 勋章 id | 必要 | |
| csrf | num | cookie中bili_jct字段 | 必要 | | | csrf | num | cookie 中 bili_jct 字段 | 必要 | |
| csrf_token | num | 同上 | 必要 | | | csrf_token | num | 同上 | 必要 | |
**json回复：** **json 回复：**
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- | | ------- | ---- | -------- | -------------- |
| code | num | 返回值 | 0：成功 | | code | num | 返回值 | 0：成功 |
| ttl | str | 1 | | | ttl | str | 1 | |
| message | str | 错误信息 | 默认为佩戴成功 | | message | str | 错误信息 | 默认为佩戴成功 |
@@ -251,7 +151,7 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
**示例：** **示例：**
佩戴勋章id为1的勋章 佩戴勋章 id 为 1 的勋章
```JavaScript ```JavaScript
var madelForm = new FormData(); var madelForm = new FormData();
@@ -293,11 +193,11 @@ $.ajax({
> http://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign > http://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign
*请求方式：GET* _请求方式：GET_
认证方式：Cookie（SESSDATA）或APP 认证方式：Cookie（SESSDATA）或 APP
**json回复：** **json 回复：**
根对象： 根对象：
@@ -307,5 +207,3 @@ $.ajax({
| ttl | str | 1 | | | ttl | str | 1 | |
| message | str | 错误信息 | 默认为当日签到奖励内容 | | message | str | 错误信息 | 默认为当日签到奖励内容 |
| data | obj | 信息本体 | 默认为空 | | data | obj | 信息本体 | 默认为空 |